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SUMMARY OF CHANGES 


Summary of Changes 
for SX20-4400-1 
VM/SP Release 2 


NEW: 


This revision documents the changes that 
have been made to the VM/SP publications 
for Release 2. 

The "Summary of VM/SP Commands and 
Service Aids" has been updated uith neui 
command formats and descriptions that 
document neuj CMS and CP Release 2 
functions for the end-user. 

The "Reserved Filetypes” section has 
been updated Mith several nei4 reserved 
filetypes. 

Descriptions of valid filenames, 
filetypes, and filemodes have been 
included. 


CHANGED : 


Minor technical and editorial changes 
have been made throughout this 
publication. 
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PREFACE 


This publication provides a quick reference 
to VM/SP. 

The section "Using VM/SP System” 
describes how to access the VM/SP system 
and control terminal operations» how to 
create files and manipulate data^ and how 
to code and debug programs using CMS. 

The section "Summary of VM/SP Commands” 
is an alphameric listing of all the VM/SP 
commands and service aids. For each 
command a brief description of its function 
is included, as well as the complete 
command format. The section also describes 
the syntax conventions used in the command 
formats and summarizes the CP privilege 
classes. 


I This publication is part of a set of 
I reference summaries that are obtainable as 
I a group under Order No. SBOF3820. 


BINDER AVAILABLE 


A handbook-sized binder, FE part number 
S229-4124, may be purchased from IBM. 
Customers may order it through their IBM 
marketing representative. IBM personnel 
should order it as an FE part from 
Meehanicsburg. 
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USING THIS PUBLICATION 


This publication includes commands and 
operands that pertain to the VM/SP System 
Control Program (5664-67). 

The following VM/SP publications should 
be used in conjunction with the first 
sections of this publication: 


PREREQUISITE PUBLICATIONS 

IBM Virtual Machine/Svstem Product t 

CMS Command and Macro Reference * 
SC19-6209 

CMS User»s Guide , SC19-6210 

CP Command Reference for General Users * 
SC19-6211 

Introduction * GC19-6200 

COREQUISITE PUBLICATIONS 

IBM Virtual Machine/Svstem Product : 

CMS Primer * SC24-5236 

EXEC 2 Reference , SC24-5219 

Operator * s Guide * SC19-6202 

Planning and System Generation Guide * 
SC19-6201 

System Messages and Codes * 5019-6204 

System Product Editor Command and Macro 
Reference , SC24-5221 

System Product Editor User’s Guide * 


Preface v 



SC24-5220 

System Programmer * s Guide * 5019-6203 
Terminal User * s Guide > GC19-6206 
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USING THE VM/SP SYSTEM 


IBM Virtjjal Machi ne/System Product 
(VM/SP) is a system control program that 
controls virtual machines. A virtual 
machine is a functional equivalent of a 
real machine which you control from your 
terminal using a command language. 

VM/SP builds and maintains, for each 
user, a virtual System/STO machine from 
a predefined configuration. 

The virtual machine configuration 
includes components corresponding to a 
real System/370: a virtual operator’s 
console, virtual storage, a virtual 
processor, and virtual channels and I/O 
devices. However, since the virtual 
machines are simulated, their 
configurations may differ from that of 
the real machine and from each other. 

For example, the real machine may have 
512K bytes of real storage and eight 
real disk drives, while a virtual 
machine may have 768K bytes of virtual 
storage and two virtual disk drives. 

The command languages correspond to 
the components of VM/SP. CP (Control 
Program) controls the physical machine 
in the computer room while CMS 
(Conversational Monitor System) is the 
conversational operating system designed 
to run under CP. You use CP commands to 
communicate with the Control Program and 
control the devices attached to your 
virtual machine. CP commands can be 
entered from either the CP or CMS 
environment; but CMS commands cannot be 
entered while in the CP environment. 
Thus, the CP and CMS command languages 
are, for practical purposes, a single, 
integrated command language for CMS 
users. 

VM/SP makes work easier with its 
ability to create, change, store, copy, 
send and print data sets of information 
called files. 
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GETTING STARTED 


Before you can start using VM/SP, you 

must have: 

• A user identification and password. 
Your user identification (userid) 
identifies you to VM/SP. Your 
password is checked when you log on^ 
and protects your virtual machine 
from unauthorized use. The VM/SP 
system operations group usually 
assigns userids and passwords. 

• A virtual machine defined for your 
use. The virtual machine definition 
should include all the devices you 
expect to use -- for example# a 
console# card reader# card punch# 
printer# and disk space. The VM/SP 
system operations group usually 
defines your virtual machine 

configuration, 

• Properly formatted disk space. The 
VM/SP system operations group usually 
formats disk space# but you can 
format your own disk space using the 
FORMAT command. See VM/SP CMS User^s 
Guide for details on formatting your 
disk space. 

Once you have your userid and password# 
you can communicate with the VM/SP system 
I from a terminal such as an IBM 3270 
I Information Display System Terminal# IBM 
I 2741 typewritei—like terminal# or IBM 1050 
i Data Communication System (or equivalent)# 
Depending on your terminal# you can either 
dial the central VM/SP computer# or you are 
directly connected to it. For a 
description of the communication procedures 
for each type of terminal# see the VM/SP 
Terminal User * s Guide . 


TERMINAL OPERATING PROCEDURES 


For a more detailed description of the 
various terminal operating procedures# see 
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the VM/SP Terminal User * s Guide . 


LOGGING ON 


First, establish communication with VM/SP 
by turning on your terminal’s power. The 
system sends a VM/370 ONLINE message or 
logo to the terminal. 

Press the attention (ATTN) key, PAl key 
(or equivalent), type logon, and identify 
yourself by entering your user 
i identification (userid) as follows: 

I 1 userid (short for logon userid) 

I Then press the Enter (or Return) key. 

If VM/SP accepts your userid, it 
responds with: 

ENTER PASSWORD: 

I Then type your password and press the Enter 
I key. Each time you press Enter the command 
1 you typed is sent to the system. 

Note : In many systems you will not see 

your password as you type it. This is a 
security measure which prevents other 
people from learning your password and 
using your system without authorization. 

For more information on this masking 
technique or using the Print Inhibit 
feature, see the VM/SP Terminal User’s 
Guide . 

1 If you make a typing error you will not 
I be able to see your mistake. VM/SP will 
I give you the error message, 

DMKLOG050E PASSWORD INCORRECT REINITIATE 

LOGON PROCEDURE 

You must start the logon procedure from the 
beginning by entering your userid again. 

If you do not do this, you are prompted by 
the message: 

RESTART 
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If thQ userid and passujord you enter are 
valid, but someone else has already logged 
on with this userid, Vfl/SP issues the 
message: 

DMKLOG054E ALREADY LOGGED ON LINE nnn 

where nnn indicates the real line address 
of the terminal on which the user is 
logged. If you want to find out why the 
userid you just entered is in use, issue 
the MSG command to send a message to the 
operator or to the other user. You should 
either log on with another userid (if 
another userid is reserved for your use) or 
try again later. 

Once you have successfully logged on and 
entered the system, VM/SP replies with a 
LOGON AT message, such as; 

LOGON AT 11:24:35 EST THURSDAY mm/dd/yy 

A logon message from the VM/SP operator (if 
any) also displays at this time. 

Now you can start using the virtual 
machine that you have set up for your 
userid. 
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When you want to end your terminal session 
you do so by logging off the VM/SP control 
program (CP). Even if you are in CMS mode# 
you need only enter the command: 

log (short for logoff) 

I and press the Enter key. VM/SP responds 
I with: 

CONNECT^ 00:11:43 VIRTCPU= 000:05.21 
. T0TCPU= 000:21.03 

I LOGOFF AT 11:34:44 EST THURSDAY mm/dd/yy 

and the connection with VM/SP terminates. 
The connect time is in hours# minutes# and 
seconds. The system displays the use of 
the virtual processor and total processor 
in minutes# seconds# and hundredths of a 
second. Only when the logoff procedure is 
completed should you turn off terminal 
power. 

Note: If you logged on over a dialed line# 
you could specify that the communication 
line be left connected so that another user 
can logon immediately from the same 
terminal. When you issue 

I log hold (short for logoff hold) 

the next user does not have to re-dial the 
( line before logging on again. 


INPUT CONVENTIONS 


i You may enter data in either uppercase or 
lowercase. The examples in this book use 
lowercase characters for user entries and 
uppercase characters for system responses. 

I To correct typing errors on a full 
I screen display terminal you can simply type 
I over the data or use the Delete key for 
g" I character deletion. 

^ To correct typing errors in entering 

commands on a line editing terminal VM/SP 
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assigns logical line editing functions to 
four special characters. These characters 
allow you to easily correct mistakes as you 
enter data. 

The logical line edit characters shown 
below are line edit default values. Your 
installation or your terminal may require 
other characters to fulfill the line edit 
functions. 

Character Delete symbol (3): The character 
delete symbol deletes the preceding 
character in the input line. A string of 
”n” character delete symbols deletes the 
preceding ”n” characters in the input line 
and itself. For example: 

ABCSa results in A 
ABC#D3oJa results in AB 

Line End symbol (#): The line end symbol 
indicates the end of a logical input line. 
Use of this character permits you to enter 
more than one logical input line in the 
same real input string. You can use this 
symbol to type several commands on the same 
line. CMS stacks the commands and executes 
them in sequence. For example: 

down l#typel#top 

executes the commands as though entered: 

down 1 
type 1 
top 


Line Delete symbol (❖): The line delete 
symbol deletes all characters in the 
current logical line and itself. If you 
enter a line delete symbol erroneously^ you 
can cancel its effect by entering a 
character delete symbol. For example: 

ABC#DEF« results in ABC 

ABC#<> results in ABC 

ABC«> deletes the whole line 
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Loqical Escape symbol ("): The logical 
escape symbol causes VM/5P to interpret the 
character following it as a data character 
(that is, to ignore it as a logical line 
editing character). This allows the system 
to interpret any of the line editing 
characters literally. For example, 
consider how you might enter the following 
line into the system: 

1 gross #2 pencils 3 92^ per dozen 

Under the VM/SP input conventions, you 
could not enter this line as shown, since 
it would be affected by the #, 3, and ❖ 
line editing symbols. For example, the # 
symbol would end the line. However, VM/SP 
interprets the line correctly if entered as 
follows: 

1 gross pencils 92”^ per dozen 

The logical escape symbol (") is not put 
into the file. 


Line Length : For all VM/SP commands, input 
line length is restricted by the physical 
limitations of the terminal device, or by 
the default record length. Lines exceeding 
the maximum number of characters (including 
blanks, backspaces, underscores, the line 
editing characters, and the tab character) 
are truncated to that line length value. 


^ Line Termination : An input data line from 

an IBM 2741 Communications Terminal is 
transmitted to the processor by pressing 
I the return key. The same function is 
I performed on the 3270 Information Display 
I System Terminal by pressing the enter key. 
I Other terminals have similar line 

I termination keys. 


ATTENTION HANDLING 


Figures 1 and 2 indicate the various 
effects of an attention interruption for 
your virtual console. Figure 3 shows the 
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screen control functions of the Enter and 
Cancel keys for display terminals. 
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FigurQ 1, Attention Handling in VM Mode 
(Part 1 of 2) 




NO 






State 

Press 1 

ATTN Key| Action 

Terminal idle; keyboard entry blocked; 
virtual machine is running 

I- ■ ■ ■■■■ --- ' “ .. ■ - 

1 i Attention interruption pending; virtual 

1 machine is running 

>1 

Keyboard activated for CP input 

Terminal receiving output from virtual 
machine 

1 

Attention interruption pending; virtual 
machine running 

>1 

Keyboard activated for CP input at 
completion of console I/O 

Keyboard activated for input to virtual 
machine; no data entered or all data 

deleted 

1 

Device end (DE) and attention status 
pending; virtual machine is running^ 

>1 

Unit exception (UE) status pending; keyboard 
activated for CP input 

Keyboard activated for input to virtual 
machine; some data entered 

1 

Unit exception (UE) status pending; virtual 
machine is running 

>1 1 Device end (DE) status pending; keyboard I 

1 activated for CP input 1 

Keyboard entry blocked; executing CP 
command 

1 or 1 Attention ignored I 

>1 1 ! 

^To perform this function on a 3270, position the cursor one position to the left of the user I 

input area (bottom line, position 0) and press the ENTER key. I 
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State 


^ > 
-0 rf 
Q< fir 
n ID 
3 
rt- 
fSJ — 
O 
O 3 
-h 

X 
ro a> 
n^3 

a 


3 

(Q 


Keyboard entry blocked; in SLEEP mode 
entered via command 


Keyboard entry blocked; in SLEEP mode 
entered via DIAGNOSE instruction 


Terminal receiving output from CP but 
not from user command 


Terminal receiving output in response 
to CP command 


Keyboard activated for CP input; no 
data entered or all data cancelled 


Keyboard activated for CP input; 
data entered 


3 

< 

3 

3 

O 

a 

ID 


Action 


Keyboard activated for CP input 


Virtual machine resumes execution 


Attention interruption pending; virtual 
machine running 


Keyboard activated for CP input 
activated for CP input 


Output line cancelled and> in some cases» 
command output is cancelled 


Attention interruption made pending; virtual 
machine is running 


Input line cancelled; keyboard activated for 
CP input 























Figure 2. Attention Handling in CP Mode 










State 

Action 

Terminal idle; keyboard entry blocked; virtual 
machine is running 

Keyboard activated for CP input 

Terminal receiving output from virtual machine 

Keyboard activated for CP input 

Keyboard activated for input to virtual machine; 
no data entered or all data deleted 

Unit exception (UE) status pending; keyboard 
activated for CP input 

Keyboard activated for input to virtual machine; 
some data entered 

Device end (DE) status pending; keyboard 
activated for CP input 

Keyboard entry blocked; executing CP command 

Attention interruption ignored 

Keyboard entry blocked; in SLEEP mode entered 
via command 

Keyboard activated for CP input 

Keyboard entry blocked; in SLEEP mode entered 
via DIAGNOSE instruction 

Virtual machine resumes execution 

Terminal receiving output from CP but not from 
user command 

Keyboard activated for CP input 

Terminal receiving output in response to CP 
command 

Output line cancelled and» in some cases* 
command output cancelled 

Keyboard activated for CP input; no data entered 
or all data cancelled 

Attention interruption made pending; virtual 
machine is running 

Keyboard activated for CP input; some data 
entered 

Input line cancelled; keyboard activated for 

CP input 
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Data 


Action 


I Resulting 
I Status 


"n 

IQ 

c 

Initial 

Status 

Mode 

Key 

Pressed 

1 Resulting 

Data Action I Status 

"J 

ID 

RUNNING 

CP 

ENTER 

NONE 

Enters console function mode 

CPREAD 





DATA 

Executes console function 

RUNNING 

s: 



CNCL 

N/A 

Clears output area 

RUNNING 

0-3 


VM 

ENTER 

NONE 

”Attn" interruption pending# VM run 

RUNNING^ 

0 Ql 

w rn< 




DATA 

”Attn" interruption pending# 
stack data# VM run 

RUNNING* 

0 o 

0 -h 



CNCL 

N/A 

Clears output area 

RUNNING 

c 

rt- 01 
— 0 



PAZCAPL on) N/A 

Clears output area 

RUNNING 

D -J 
)Q 0 

0 

O D 

3 

to 

MORE 

CP/VM 

ENTER 

NONE 

[Holds screen output 1 

[ HOLDING 




DATA 

"Attn” interruption pending# 1 

stack data I 

MORE 

batu 

and 



CNCL 

N/A 

Clears output area# continues 
output 

1 RUNNING 

1 

UI 

o 

*0 >■ 

HOLDING 

CP/VM 

ENTER 

NONE 

[Allows screen output to continue I 

1 MORE 

ct i o 
(Pa 

i 



DATA 

"Attn" interruption pending# stack 
data 

1 HOLDING 

1 


-0 -• 
Q> o 


CNCL 


N/A 


Clears output area# continues 
output 


RUNNING’ 


















Figure 3. Summary of Screen Status Action 
while Executing CMS and CP (Part 










CPREAD 

CP/VM 

ENTER 

1 

NONE 

|"Null” line return 

1 

RUNNING^ 




1 

1 

DATA 

iData return for function 

1 

RUNNING 



CNCL 

1 

N/A 

IClears output area 

1 

CPREAD 

VMREAD 

CP/VM 

ENTER 

1 

1 

NONE 

|"Null" line return, VM run 

1 

RUNNING 




1 

1 

DATA 

iData return for read, VM run 

1 

RUNNING 



CNCL 

1 

N/A 

jClears output area 

1 

VMREAD 



PA2 1 

(if APLl 
on) 1 

N/A 

{Clears output area. Present 
{external interruption to virtual 

1machine. 

1 

1 

1 

RUNNING 


NOT 

ACCEPTED 


A previously stacked input buffer is still pending 


Returns to 
former status 


'The status shown is RUNNING; however, the virtual machine should respond to the 
Attn with a read, whereupon the status goes to VMREAD. 

*If a data buffer is already stacked for a virtual machine, the terminal displays 
NOT ACCEPTED status before returning to the RUNNING status. 

^If you are running with TERMINAL MODE CP (the default for the primary system operator) 
then an attention return is also made, causing cancellation of the function. 

Operators at the 158 and 3066 display console as well as the 3036 display console for 
the 3031, 3032, and 3033 processors use this function to allow termination of certain 
QUERY or DISPLAY functions because consoles do not have a PAl key. 

^Unless you are the VM/370 primary system operator or are using the SET RUN ON 
option, the status returns to CP READ for another console function if the previous 
read was for a console function. 














USING CMS 


I The CMS (Conversational Monitor System) 

1 component of VM/SP allows you to create, 

I compile, execute and test program problems, 

I and in general create and manage data 
I files. 

Before you can use CMS, you must do the 
following: 

• Log on with a valid user identification 
and password. The user identification 
should have a virtual machine defined 
for its use. 

• Initial program load (IPL) the CMS 
system by specifying the name of the CMS 
system or the device address of the CMS 
system disk. 

• Have disk space available that is 
formatted for use by CMS. 

The logging on procedure is discussed in 
the "Terminal Operating Procedures" section 
of this book. The IPL procedure is 
described in this section. Disk formatting 
is detailed in VM/SP CMS User * s 6uide . 


HOUl TO IPL CMS 


I If your system does not have "automatic 
I IPL", you need to load CMS into your 
I virtual machine by entering a command. 

I Type: 

I ipl cms 

I - or - 

I ipl 190 

I Press enter. VM/SP responds with a ready 
i message which usually looks like: 

! R; T=7.36/19.87 09:26:12 
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If you have properly formatted disk space 
available you can now use the facilities of 
CMS. 


CMS SYSTEM PRODUCT EDITOR 


The part of the VM/5P system that helps you 
manipulate files is called the System 
Product editor, or XEDIT. Its enhancements 
include: 

• Full screen editing 

• Multiple views of the same file 

• Multiple files viewed on the same screen 

• Selective column viewing 

• Automatic wraparound of lines that are 
longer than the screen 

• Ability to issue selected commands 
directly from the displayed line 

• Ability to define screen formats as 
preferred 

For a thorough understanding of the 
System Product editor (XEDIT) and its 
diverse uses, see VM/SP System Product 
Editor User * s Guide and VM/SP System 
Product Editor Command and Macro Reference . 


Using CMS 15 



EXEC 2 INTERPRETER 


I An EXEC is a CMS function that allows you 
I to craatc new commands by setting up 
I frequently used CP or CMS commands# 

I together with conditional branching 
I facilities. This eliminates the 
I repetitious re-keying of those commands. 

I The sequence of commands is executed when 
I you enter the filename of the EXEC. 
Coexisting with the EXEC processor 
currently in use# the EXEC 2 interpreter 
features: 

• Acceptance of 255-character words 

• Issuance of commands to either CMS or to 
specified other subcommand environments 

• String manipulation functions 

• Arithmetic functions for multiplication 
and division 

• Debugging facilities 

• Support for usei—defined functions and 
subroutines 

For a thorough understanding of the 
system product EXEC 2 interpreter# see 
VM/SP EXEC 2 Reference . 


SYSTEM PRODUCT EDITOR (XEDIT) FEATURES 

I The system product editor (XEDIT) provides 
I for expansion and flexibility in language 
I with the following: 

• Extended string search to facilitate 
text processing 

• Automatic update generation functions 

• Packed file handling functions 

• CMS HELP Facility support 

• Column pointer for intraline editing 
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• Line splitting and/or joining functions 

• Import and/or export of data facilities 

• Macros for use in migrating from EDIT or 
DES (display editing system) 

• Macro writing capabilities to expand the 
basic subcommand language and to tailor 
the language to your own application. 


EXAMPLE OF CMS PROGRAM DEVELOPMENT 
FACILITIES 


This section illustrates several CMS 
functions that are useful in creating and 
manipulating CMS files. 


CREATING AN ASSEMBLER LANGUAGE SOURCE FILE 


The program shown in Figure 4 in this 
section is an Assembler Language program 
that reads data from one CMS file and 
writes it to another CMS file. After you 
have logged on the system and issued IPL 
CMS, you can create the program using the 
CMS XEDIT facility. 
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Figure 4. Sample Assembler Language 
Program Used for Creating 
Source File (Part 1 of 2) 


xedit manip assemble 
NEW FILE: 

XEDIT: 
i nput 
INPUT: 

manip csect 

print nogen 
save C14#12),,X 
balr 12,0 

using ^,12 establish addressability 

la 2,8(,1) r2=addr of input file in plist 

la 3,32(,1) r3=addr of output file in plist 

X determine if input file exists 
fsstate (2),error=errl 

^ read a record from input file and write on output file 
rd fsread (2),error=eof,buffer=buffl,bsize=80 

fswrite (3),error=err2,buffer=buff1,bsize=80 
b rd loop back for next record 

X come here if error reading input file 
eof equ X 


Of 



Program Used for Creating 
Source File (Part 2 of 2) 








o 

3 


Tl 

to 

c 

T 

ID 


tn 

Ci 

3 

*0 

ID 


in 

w 


3 

CT 


la 15>7 test code for read error 

c 15>=f»12* end of file? 

bne errS error if not 

return (14»12),rc=0 
^ if input file does not exist 
errl wrterm ’file not found’,edit=yes 

b erret 

^ if error writing file 

err2 linedit text=’error code . in writing 

b errt 

^ if reading error was not normal end of file 


err3 

erret 

buffi 


linedit text=’error code . in reading 

return to caller 


return (14,12),rc=l 
ds cl80 
end manip 

(Press the RETURN key to leave Input mode.) 


file’, 
file’, 


5ub=(dec,(15 ) ) 


5ub=(dec,(15) ) 


□ 

to 

c 

01 

to 

ID 


XEDIT: 

file 

R; 





I The Editor (the term applied to the edit 
I program that is used by the XEDIT command)# 
did not find a file with the filename and 
filetype of MANIP ASSEMBLE# so it created 
the file for you. Enter the INPUT 
subcommand so that you can enter your 
program code into the file. You must issue 
the FILE subcommand in order to save your 
program. 

This program (MANIP CSECT) uses several 
CMS macros; when it is assembled# this 
program requires the CMS macro library. To 
identify the macro libraries to be searched 
issue: 

global maclib cmslib osmacro 

The Load Address (LA) instruction following 
EOF (end-of-file) is inserted only for 
testing; it is deleted after the function 
is tested. 


ASSEMBLING A SOURCE FILE 


To assemble the MANIP program# you enter 
the "ASSEMBLE MANIP” command# then wait for 
the assembler to complete processing. The 
assembler expects to find a CMS file with 
the filetype ASSEMBLE. 

assemble manip 

I ^ 

I ^ 

I ^ 

ASSEMBLER (XF) DONE 


MAN00331 B ERRT 

IEU024 NEAR OPERAND COLUMN 1-UNDEF SYMBOL 

1 STATEMENT FLAGGED IN THIS ASSEMBLY 
8 WAS HIGHEST SEVERITY CODE 
R(00008); 

Each asterisk (3<) on the second line 
indicates two seconds of virtual processor 
time. The message IEU024 indicates an 
error in your program. The line in your 
program containing the error has a sequence 
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number of MAN00331. Display or print your 
listing file to find this line. 

At this pointy three files are 
associated with your program. 

Firsts the MANIP ASSEMBLE file contains 
the source statements of your program. 

This file was the input used by the 
Assembler Language program. The output 
from the assembler is two permanent files# 
MANIP TEXT and MANIP LISTING. 

The MANIP TEXT file contains the object 
module. 

The MANIP LISTING file contains a 
listing of the source statements^ assembled 
machine code» and other associated 
information based on the options selected 
for the ASSEMBLE command. 


Correcting Errors 


Since the assembler has detected an error 
in the source code» you must correct the 
error before attempting to execute the 
program. Just as you used the editor to 
create the assembler file, you also use the 
editor (either the CMS Editor or the System 
Product Editor (XEDIT)) to change or 
correct the assembler file. When you issue 
the XEDIT MANIP ASSEMBLE command this time, 
the editor finds your file and enters edit 
mode. Then issue the LOCATE subcommand to 
find the line in error. Issue the CHANGE 
subcommand to correct the error and then 
issue FILE to save the corrected program. 
The terminal output is as follows: 

j xedit manip assemble 
I XEDIT: 

locate /errt/ 

B ERRT 

change /errt/erret/ 

B ERRET 

f i le 
R; 


Now that the error has been corrected. 
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you can assemble the file again: 


assemble manip 


ASSEMBLER (F) DONE 

NO STATEMENTS FLAGGED IN THIS ASSEMBLY 
R; 


This time, the program assembled without 
any assemblei—detected errors. The TEXT 
and LISTING files from the previous 
assembly arc erased automatically and 
replaced by the new ones from the current 
assembly. 


CREATING A LOAD MODULE 


You can now create a load module from the 
TEXT file that was created by the 
assembler. The resulting MODULE file can 
then be executed. 

load manip 
R; 


genmod manip 
R; 

Now, a fourth file, MANIP MODULE, 
exists. This file is in executable form. 
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Testing and Correcting a Program 


Once the MODULE file has been created^ you 
can begin testing. To execute the MANIP 
MODULE file# issue the MANIP command name# 
plus the file identifiers for the input and 
output files. The input file (MANIP 
ASSEMBLE Al) is to be copied and the 
resulting file is to be called MANIPl 
ASSEMBLE Al. The first test should take 
the branch on the FSREAD error. The 
following error message appears on the 
terminal: 

manip manip assemble al manipl assemble al 
ERROR CODE 7 IN READING FILE. 

R(OOOOl); 


You should then use the Editor to 
correct the program so that this branch is 
no longer taken. 

I xedit manip assemble 
I XEDIT; 
find eof 
EOF EQU X 
next 

LA 15,7 TEST CODE FOR READ ERROR 

delete 

file 

R# 
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After the corrected version of the 
program is filed, assemble and execute the 
program again. 

assemble manip 
X 
X 
X 

ASSEMBLER (F) DONE 

NO STATEMENTS FLAGGED IN THIS ASSEMBLY 
R; 

load manip 
R; 


genmod manip 
R; 


Now that the testing statement has been 
deleted, and a new MODULE file created, 
further testing of the program can begin. 
First, attempt to copy a file that does not 
exist. The file is not found. 

manip filel assemble al file2 assemble al 

FILE NOT FOUND 

R(OOOOl); 

Then, attempt to copy a file to itself. 
Your program is not equipped to do this; an 
error occurs. 

manip manip assemble al manip assemble al 
ERROR CODE 9 IN WRITING FILE. 

R(OOOOl); 

Finally, create a new file (MANIPl) from 
your MANIP file. 

manip manip assemble al manipl assemble al 
R; 


ERASING UNWANTED FILES 


Once testing is complete, display the 
beginning of MANIPl to make sure that it 
was copied correctly, then delete the 
MANIPl file: 
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type manipl assemble 1 5 


MANIP C5ECT 

PRINT NOGEN 

SAVE C14,12),,x 

BALR 12,0 

USING ^,12 ESTABLISH ADDRESSABILITY 


R; 

erase manipl assemble 

R; 


Or type DISCARD in the ”Cmd” space next 
to the file you no longer want from the 
FILELIST screen. Then press PFIO (not the 
Enter key) to execute it. 

The LISTFILE or FILELIST command can 
then be issued to make sure the file was 
erased: 

listfile ^ assemble 
MANIP ASSEMBLE A1 
R; 
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PRINTING, PUNCHING, AND READING FILES 


Printing 


When you want to print your program 
listing, you should first check the output 
status of your virtual printer by entering: 

query OOe 

PRT OOE CL A COPY 01 

R; 


Since output class A is acceptable for 
program listings, print the LISTING file: 

print manip listing 
R; 


You can also print the LISTING file by 
specifying the PRINT option when you issue 
the ASSEMBLE command. Once the LISTING 
file is printed, it can be erased. Also, 
you may want to erase the TEXT file from 
which the MODULE file was generated: 

erase manip listing 
R; 


erase manip text 
R; 


Punchinq 


If other users want to use your MANIP 
program, send it to them by changing the 
destination of your virtual punch, then 
punch the MANIP TEXT file. Use the CMS 
COPYFILE or MOVEFILE commands to transfer 
the MANIP MODULE file to another user. For 
example, suppose the user PAYROLL wanted to 
use the MANIP program. You could send 
PAYROLL a copy of the TEXT file by 
entering: 

spool OOd to payroll 
R; 
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punch manip text 

PUN FILE 029 TO PAYROLL 

R; 

Or simply use the SENDFILE EXEC procedure. 


Reading 


When the user PAYROLL logs on the VM/SP 
system, the following message types during 
the logon procedure: 

FILES: 001 RDR, NO PRT, NO PUN 

The PAYROLL user can decide whether or 
not he wants the file before he reads it by 
invoking the command: 

query reader all 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TEXT DI5T 

NET4 1014 A PUN 0000051 001 NONE 08/17 12:36:03 MANIP TEXT G41/ 


To read in this file, the PAYROLL user must 
IPL CMS and issue the command: 

read ^ 

:READ MANIP TEXT A1 PUBS mm/dd/yy 13:29:03 
R; 

If the PAYROLL user does not want the 
file, he can purge it from his reader, as 
follows: 

purge reader (or purge reader 029) 

0001 FILE PURGED 


Or issue the RDRLIST command to display 
information about files in your reader. 

Then choose to receive, discard, replace, 
rename, or peek at the file from the ”Cmd” 
space. 

CMS can be used for many other purposes. 
Those functions illustrated in the previous 
discussion are intended to help the new 
VM/SP user become acquainted with the 
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system and its capabilities. Once you are 
familiar with these commands and functions, 
you have a sound base upon which to build a 
more thorough understanding of the VM/SP 
system. 
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RESERVED FILETYPE DESCRIPTIONS 


€ 

f 




i 


Figure 5 lists the filetypes used by CMS 
and CMS/DOS commands. 

In addition to these CMS filetypes» 
there are special filetypes reserved for 
use by the language processors# which are 
IBM program products. For details# consult 
the appropriate program product 
documentation. 

A fileid is a CMS file identifier that 
consists of a filename# filetype# and 
filemode. The fileid is associated with a 
particular file when the file is created# 
defined or renamed under CMS. 

I A valid filename consists of a 1- 
1 8*"character alphameric field# comprised of 
I A-Z# a-z# 0-9. and special characters $ # a 
I + - (hyphen) : (colon) __ (underscore)# that 
I is part of the CMS file identifier and 
I serves to identify the file for the user, 

I A valid filetype consists of a 1- 

8-character alphameric field# comprised of 
I A-Z# a-z# 0-9. and special characters $ # a 
I + - (hyphen) : (colon) __ (underscore)# that 
I is part of the CMS file identifier and 
I serves to identify the file for the user. 

I A valid filemode is a 2-character CMS 
I file identifier field comprising the 
I filemode letter (A through Z) followed by 
I the filemode number ( 0 through 5). The 
I filemode letter indicates the CMS file 
I directory on which the file resides and 
I whether or not the disk is a user virtual 
I disk or a CMS system.disk. The filemode 
I number indicates the access mode of the 

I disk. 
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Format 

1 

Filetype 

Command 

Usage 

Filename 

RECFMI LRECL 

Contents I 


TAPE LOAD 

f i les 

TAPE 



1 

1 


UPDATE 


f n 



1 


INCLUDE 


DMSLDR 



1 


LOAD 


DMSLDR 



1 


MACLIB 


DMSLBM 



i 


EDIT 


EDIT 



1 

CNTRL 

UPDATE 

XEDIT 

Input 

f n 

F 

80 

Control file update 1 

COBOL 

COBOL 

Input 

fn 

F 

80 

COBOL source statements 1 

COPY 

MACLIB 

Input 

f n 

F 

80 

COPY control cards j 







and macro definitions j 


SSERV 

Output 

f n 



A book from a DOS/VS j 







source library. j 

DIRECT 

DIRECT 

Input 

fn 1 

1 

1 F 

80 1 

User Directory entries j 

DOSLIB 

DOSLIB 

Input 

fn 

1 ^ 

1024 

CMS/DOS phase library 1 


DOSLKED 

Output 

f n 



1 


FETCH 

Input 

f n 



1 


GLOBAL 

Input 

f n 



1 

1 

DOSLNK 

DOSLKED 

Input 

fn 

j F 

80 

1 

Linkage editor control | 







statements for input to I 
CMS/DOS linkage editor | 
_1 
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fn 

?a 
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U1 

ID 

-J 

1 

IGEN3705 
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1 

ILISTIO 
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< 

10 

1 

IFREEFORT 

I 

IGOFORT 
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Collection of named 
variables 
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RETURN CODES 


If a condition arises during execution of a 
command that results in the display of a 
Warning, Error, Severe Error, or Terminal 
Error message, the command passes a nonzero 
return code to register 15. 

If no Warning, Error, Severe Error, or 
Terminal Error messages are generated 
during execution of the command, the return 
code passed to register 15 is zero. 

Commands that invoke Program Products 
pass the return code set by the program in 
register 15 to the user. This code may 
have the same number as a CMS code 
described above; houever, it Mill have been 
redefined by the Program Product or 
compiler in operation. 


CMS RETURN CODES 


Figure 6 shows the return codes passed by 
CMS commands. 


RC 

Meaning 

■ 

No CP command with this name was 1 
found. CThe CP error code of +1 is| 
converted by CMS to -0001 for j 
commands entered from the virtual 1 
console.) j 

-0002 

An attempt was made to execute a i 
CMS command while in CMS subset j 
mode, which would have caused the j 
module to be loaded in the user j 
area (LOADMOD error code 32). | 

Fi gure 

6. Return Codes Produced by CMS 
(Part 1 of 3) 
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FiguPG 6. Return Codes Produced by CMS 
CPart 2 of 3) 
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RC 

Meaning 

32 

-The user’s file is not in the 
expected formats or 
-The user’s file does not contain 
the expected information. 

36 

An error for which the user is 
responsible occurred on one of the 
user’s devices. For example# a 
disk is in read-only status, and 
needs to be in write status so that 
a file can be written on it. 

40 

-A functional error for which the 
user is responsible occurred 
during execution of the command, 
or 

-The user failed to supply all the 
necessary conditions for executing 
the command, or 

-End-of-file, end-of-tape (where 
applicable). 

41 

-Insufficient storage was available 
to execute the command. 

88 

i 

-A CMS system restriction prevented 
execution of the command, or 
-The function requested is an 
unsupported feature, or 
-The device requested is an 
unsupported device. 

mm 

Input/output device errors. 

1 104 

A functional error for which the 
system is responsible occurred 
during execution of the command. 

1 256 

I 

All unexpected errors for which the 
system is responsible; that is. 
Terminal Error messages. 

Fi gure 

6. Return Codes Produced by CMS 
(Part 3 of 3) 
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CP DIRECT COMMAND RETURN CODES 


Figure 7 shows the return codes passed by 
the CP DIRECT command. 


RC I Meaning 

- 1 - 

1 linvalid filename, or file not 
I found. 

I 

2 jError loading the directory. 

3 jlnvalid option from CMS. 

I 

4 (Directory not swapped, user not 
(privilege class A, B, or C. 

I 

5 (Directory not swapped, system (old) 
(directory locked. 

( 

6 (Directory not swapped, the 
(directory in use by the system is 
jnot the updated directory. 

Ixx^(Error in the CMS RDBUF routine. 

2xx^(Error in the CMS TYPLIN routine. 

^xx is the CMS routine return code. 

Figure 7. Return Codes Produced by the CP 
DIRECT Command 
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CMS DDR COMMAND RETURN CODES 


Figure 8 shows the return codes passed by 
the CMS DDR command. 


RC 

Meaning 

1 

Invalid filename^ or file not 


found. 

2 

Error in executing the program. 

3 

Flagged DASD (Direct Access Storage 


Device) track. 

4 

I 

Permanent tape or DASD I/O error. 

Ixx^ 1 

Error in the PRINTIO routine. 

j 

2xx^ 1 

Error in the CONREAD routine. 

3xxi 1 

Error in the RDBUF routine. 

4xx^ ! 

Error in the TYPLIN routine. 

1 1 

1 ^xx is the CMS routine return code. I 

i _1 


Figure 8, Return Codes Produced by the 
CMS DDR Command 
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SYSTEM PRODUCT EDITOR (XEDIT) COMMAND 
RETURN CODES 


Figure 9 shows the return codes passed by 
the XEDIT command. 


RC 

1 Meaning 

nn 

1 

ICommand’s RC specified as operand 

-1 

ILOAD command has already been 
{issued 

0 

1 Normal 

1 

ITOP or EOF reached during execution 

2 

(Target line not found 

3 

(Terminal is not a display terminal 

4 

(Insufficient storage 

5 

(invalid operand 

6 

(Subcommand rejected in the profile 
(because of LOAD error 

7 

(Error when building the update file 

8 

(Prefix area contains subcommand 
(that is not yet executed 

12 

(Disk is read-only 

Fi gure 

9. Return Codes Produced by the 
System Product Editor (XEDIT) 
Command (Part 1 of 2) 
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RC 

Meaning 

13 

Disk is full 

20 

Invalid character in filename or 
filetype 

24 

Invalid filemode 

28 

Source file not found (UPDATE MODE) 
or specified PROFILE macro does not 
exist, or file XEDTEMP CMSUTl 
already exists 

32 

Error during updating process 

36 

Disk has not been accessed as yet 

88 

File is too large; cannot fit into 
storage 

100 

Error occurred while reading the 
file into storage 

Fi gure 

9. Return Codes Produced by the 
System Product Editor (XEDIT) 
Command (Part 2 of 2) 


IPCS COMMANDS RETURN CODES 


Figure 10 shows the return codes passed by 
the IPCS commands. 


IRC I Meaning 

I-1- 

I 4 jAn incorrectly entered parameter. 

I 8 I System failure; a read/write error 
I lor an invalid internal parameter. 

I_ 

Figure 10. Return Codes Produced by the 
IPCS Commands 
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EXAMPLE OF A RETURN CODE FROM A CP COMMAND 


Commands or functions of commands passed 
to CP pass the return code sent back by CP 
to register 15. For example# suppose the 
user is in CMS mode and invokes the CP 
command LINK: 

ipl cms 

CMS VERSION n.n mm/dd/yy 


cp link to X vaddrl as vaddrZ r 

The user has entered the CP command LINK 
to userid That means the user’s own 

directory is searched for device vaddrl. 
Vaddr2 is the virtual address to be 
assigned to the device for this virtual 
machine. Read-only access is requested. 
No password is required because the user 
has linked to one of his own disks. 

The result may be either 

R; which indicates successful 

execution. 


— or -- 

R(nnnnn); which indicates an error. 

If# as previously described# 
the contents of nnnnn is a 
CMS return code# then the 
error occurred in CMS. If 
nnnnn contains a CP message 
number# the error occurred in 
CP. 


The return code may be used by a system 
programmer in the DEBUG subcommand and 
also in EXEC procedures. See the VM/SP CMS 
( Command and Macro Reference or EXEC 2 
I Reference for a description of the 
&RETC0DE special variable. 
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SUmARY Of VM/SP COMMANDS AND 
SERVICE AIDS 


Th 0 following list contains CP, CMS, IPCS, 
and RSCS commands and the VM/SP service 
aids; a brief description precedes a 
syntactic representation of each command. 


NOTATIONAL CONVENTIONS 


The following symbols should be coded as 
they appear in the command format. 

asterisk x 

comma , 

hyphen 

equal sign = 

parentheses () 

period 

colon : 


The following symbols are used to 
define the command format and should not 
be coded as part of the command. 


braces { } 


brackets Cl 


underscore 


vertical bar 


indicate choices, one of 
which must be selected. If 
a list of choices is 
enclosed by neither 
brackets or braces, it is 
to be treated as if 
enclosed by braces. 

indicate optional choices, 
one of which may be 
selected. 

indicates a default 
option. If the 
underscored option is 
selected, it need not be 
specified. 

separates the operand 
alternatives within the 
brackets and braces. 
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ellipsis ... indicates that the 

preceding item may be 
repeated more than once. 

The commands and subcommands are shown 
in uppercase and lowercase; the uppercase 
represents the minimum truncation of the 
command or keyword operand that the system 
accepts. An all-lowercase operand 
indicates a usei— or system-supplied 
variable value. Variable abbreviations 
used are shown in Figure 11. 


Short Form 

! Meaning 


(Alphameric information 

addr 

[Storage address 

cc 

[Cylinder number 

col 

[Column 

cuu 

[Virtual device address 

cyl 

1Cylinder 

dasd 

[Direct access storage device 

fileid 

Ifn ft [fm] 

fm 

(filemode 

f n 

1filename 

ft 

1filetype 

hexloc 

[hexadecimal storage location 

mode 

[Mode letter or mode letter and 

1 mode number 

nn 

[Decimal information 

psw 

[Program status word 

raddr 

[Real storage address 

rec 

[record 

vaddr 

[Virtual storage address 


Figure 11. Syntax Abbreviations Used 


For a detailed and thorough explanation 
of command formats and notational 
conventions# see the VM/SP CMS Command and 
Macro Reference . 
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CP PRIVILEGE CLASSES 


VM/SP users are divided into seven classes 
(A through G) according to the functions 
they must perform. Each user class may 
use a specific subset of CP commands. In 
addition, there are commands (class Any) 
available to all users. 

Figure 12 summarizes the CP privilege 
classes and the functions performed by 
each class of user. Figure 12 also 
indicates the publications in which the 
commands for each class are detailed. 


Class 

User and Function 

. 

Ai 

Primary System Operator: The class 

A user controls the VM/SP system. 
Class A is assigned to the user at 
the VM/SP system console during 

IPL. The primary system operator 
is responsible for the availability 
of the VM/SP system and its 
communication lines and resources. 

In addition the class A user 
controls system accounting, 
broadcast messages, virtual machine 
performance options, and other 
command operands that affect the 
overall performance of VM/SP. The 
system operator controls operation 
of the real machine using the 
system control panel and console 
device. 

1 1 

1 ^Described in VM/SP Operator’s Guide. 1 

1_1 


Figure 12. CP Privilege Class Descriptions 
(Part 1 of 3) 
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Class! User and Function 


1 Note ; THg class A system operator 
jwho is automatically logged on 
[during CP initialization is 
[designated as the primary,system 
[operator. 

I 

I System Resource Operator ; The 
[class B user controls allocation 
[and deallocation of all the real 
[resources of the VM/SP system^ 
[except those controlled by the 
[primary system operator and 

[spooling operator. 

[ 

I System Programmer : The class C 
[user updates certain functions of 
[the VM/SP system. The system 
[programmer can modify real storage 
jin the real machine. 

I Spoolinq Operator : The class D 
[user controls spool data files and 
[specific functions of the system’s 
[unit record equipment. 

! 

I System Analyst : The class E user 
[displays the contents of real 
[storage, performs the functions 
[required to generate saved systems 
[and discontiguous saved segments, 
[and controls the collection and 
[recording of performance 
[measurement data. This class of 
[user can display the contents of 
[specified real storage areas on the 
[virtual operator's console or on a 
[spooled virtual printer, but cannot 
[modify real storage. 


^Described in VM/SP Operator's Guide . 


Figure 12. CP Privilege Class Descriptions 
(Part 2 of 3) 
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j Class 

User and Function 


Service Representative:The class F 

user obtains and examines, in 
detail, certain data about input 
and output devices connected to the 
VM/SP system. The service 
representative can establish 
intensive recording mode for one 

I/O device at a time and can cause 

the recording of repressable 

machine check errors to be 
initiated or resumed. 

Ig^ 

1 

General User: The class G user 
controls functions associated with 
the execution of his virtual 
machine. A general user cannot 
display or modify real storage. 

1 Any2 j 

1 

The Any classification is given to 
certain CP commands that are 
available to any user. These are 
primarily for the purpose of 
gaining and relinquishing access to 
the VM/SP system. 

Ih 

1 

Reserved for IBM use. 

^Described in VM/SP Operator’s Guide. 1 

^Described in VM/SP CP Command Reference 1 

for General Users. 1 

1 


Figure 12. CP Privilege Class Descriptions 
(Part 3 of 3) 
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CP, CMS, R5CS, AND IPCS COMMANDS 


The follouiing table details command 
formats and descriptions. Also included 
are macro formats and service aids. 
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Description 


Permits comments 


Permits comments 


CP Class Any 


A£CESS CMS 

Defines direct access space to a 
CMS virtual machine and relates 
it to a logical directory. 


ACNT CP Class A 

Creates accounting records. 


ADSTOP CP Class G 

Halts the virtual machine's 
execution. 

AMSERV CMS 

Defines VSAM catalogs, data 
spaces, or clusters. 

Alters, lists, copies, deletes, 
exports, or imports VSAM catalogs 
and data sets. 


anycomment 


M anycomment 


ACcess r cuu mode t/ext ffn [ft [fm 111] [(options...!)]] 1 

X 


op t ion s; 

[NOPROF] [ERASE] [NODISK] 

ACNT ( useridl [userid2...] 
} ALL [CLOSE] 

I CLOSEl 

ADSTOP { hexloclOFF > 


AMserv fnl [fn21 fnl ][(options...[)]] 

[PRINT? [TAPIN ClSnlTAPn}] [TAPOUT {ISnjTAPn}] 
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ASM3705 CMS 

Invokes the 3705 assembler. 

Note : All of the options of the 
3705 XF Assembler are 
supported and may be used 
with the ASM3705 commands 
with the exception of 
ALIGNINOALIGN and TESTi 
NOTEST. 


I ASMGEND CMS 

I Builds the system assembler and 
creates the associated auxiliary 
I directory. (System programmers 
I only) 

{ ASSEMBLE CMS 

I Invokes the system assembler. 


ASM3705 fn C(options...[)]3 

options : 

[ LIST IN0LIST3 

[ LINECOUN 55ILINEC0UN nn] 

[ disk IprintTnoprint] 

[ XREF INOXREF] 

EDECKI N0DECK 3 

ERENTI NORENT ] 

E L0AD IN0L0AD3 


Assemble fn [(options...E)33 


listing cpjit.r.ol gj 

E AL0GIC IN0AL0GIC3 

EESDIN0ESD3 

E LIST IN0LIST3 

EMCALLI NOMCALL 3 


Ltions: 

EMLOGICI NOMLOGIC 3 
ERLfilNORLD 3 

ELIBMACI NOLIBMAC 3 
E FLAG (O)iFLAG (nnn)3 


E LINECOUN (5521LINECOUN (nn)3 

E disk IprintTnoprint3 

EXREF (FULL)I XREF ( SHORT )IN0XREF3 
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Description 


ASSEMBLE (cont.) 


ASSGN CMS 

Assigns or unassigns a system or 
programmer logical unit for a 
virtual I/O device. 


output control options : 
[PECKl NODECK l I 

[TESTI N0TEST 3 

SYSTERM options ; 

[ NUMBER INONUM] [ 

[TERMIML I NOTERM] 


COBJECII NOOBJECT] 


CSTMTlNOSTMT] 


other options ; 

[ ALIGN INOALIGN] [ BUFSI2E (STD) IBUFSIZE (MIN)|BUFSIZE (MAX)] 
[RENTI NORENT ] [SYSPARM (string)ISYSPARM (?)|SYSPARM ()] 
CWORKSIZE ( 2048K ) | WORKSIZE (nnnnnk)] 

[YFLAGI NOYFLAG ] 


C(options...[)]] 


ASSGN SYSxxx f Reader \ [(options...!)]] 

I punch i 

iPRinter f 
/ Terminal \ 

\TAP [nil]/ 

I mode I 

f ign 1 

\UA ) 

[ UPCAsl ilOMCASE] [7TRACK|9TRACK] CTRTCH a] EDEN den] 







Summary of VM/SP Commands 


ATTACH CP Class B 

Attaches a real device to a 
specified user or to the system. 


ATTACH CHANNEL CP Class B 

Attaches a channel to a 
designated user. 


ATTach raddr [To] iuserid [As] vaddr [R|/0]] 
{system [As] volid 


iraddr... / 

{raddr-raddri [TO] userid [R[/0]] [3330V] 
ATTach CHANnel c [PROC nn] [To] [useridjx] 


ATTN CP Class G 

Makes attention interruption 
pending. 


ATTN 



AUTOLOG CP Class A,B 

Logs on any virtual machine 
that is defined in the VM/370 
directory. 

BACKSPAC CP Class D 

Restarts or repositions a 
current spool file. 


AUTOLOG userid passNord [variable data] 

Printer Format t Punch Format : 

BAckspac raddr^File 1 BAckspac raddr [ File ] 

{pages [EOF]) 
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Description 

BACKSPAC RSCS 

Restarts or repositions spool 
file processing. 

BEGIN CP Class G 

Starts the execution of a virtual 
machine. 


CHANGE CP Class D 

Alters the attributes of a closed 
spool file. 


BAckspac ClinkidlC FILE lnnn] 


Begin Chexloc] 


userid 
SYSTEM 

X 


Reader 

Printer 

punch 


NAinejfnlftljl 
Idsname) j 


Class cl 
spool i d 
FORM forml 
ALL 


Class c2 
copyC X]nnn 
[HOLDINOHOLD] 
[SYSINOSYS] 

DIst distcode 
Flash name nnn 
Modify name [n] 
CHars namel 

tname2i-3C**43] ] 
CHars namelCCHars 
name2C-3C-43 3 3 
FCB name 
FORM form2 
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CHANGE CP Class G 

Alters the attributes of a closed 
spool file. 


CHANGE RSCS 

Alters the attributes of a closed 
spool file. 


Change 


Reader i^CLass cl ^ 
Printer w spool i d v 
Punch \j FORM forml( 

Hall ; 


CLass c2 
COpyCx]nnn 


HOld 

NOHold 


DIst dist 
copy C><]nnn 
V^Lash name nnn 

Modify name Cnl 

^CHars namel Cname2 [name3 Cname4]]] 
/CHars namel CCHars name2CCHars 
nameSCCHars name4]]] 

(FCB name 
FORM form2 


NAME ifnCft] 
Msname 


Change [linkidl spool id 


PRIority nn 
^CLass c 
jCOpy nn 
vHOldlNOHOLD 
joist distcode 
^Name ifn CftlJ 
(dsname i 


'One of these options must be chosen; houjever^ more than one may be specified and they may be 
in any sequence. 

*0ne of these options must be chosen; however^ more than one may be specified. They may be 
combined in any sequence on the command line» except for NAME which» if specified^ must be the 
last entry in the command line. This is contrary to the notation normally used in this 
publication. 
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I Description Forma 

ICLOSE CP Class G Close /r 

I Terminates spooling operations liReaderr -i 

on a virtual reader* printer, or I Ivaddr IHOld | 

punch. I i NOHoldj 


CWD 

Executes 
mands in 
tor’s vir 


selected CP or CMS com- 
the Programmable Opera- 
tual machine. 


I r r n 

CONsole purge 

I Printer FORM form 

! punch r T r -i 

vaddr HOld [CDIst distcodel|NAmeifnCft]( 

NOHoldl i MsnameH 

L J L J 


Controls the logging of I/O 
activity on a specified RSCS 
link or passes control 
information to remote batch 
processor. Available to RSCS 
operator only. 

CMDCAIL CMS CMDCALL 

Converts EXEC2 extended plist 
function calls to CMS extended 
plist command calls. 


RSCS iCMD linkid {textlLOGlNOLOG} 


£cmd [operandl CoperandE ...operandnlll 
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*o 


CMSBATCH CMS 

Invokes the CMS Batch Facility, 
creating a virtual machine 
running in batch mode. 


CMSBATCH Csysnamel 


CMSGEND CMS 

Generates a new CMS module from 
a text file and places the new 
CMS module on the A-disk. 


CMSGEND fn 


CTLCMS 

CTLALL 

NOCLEAR 

MAP 

NOINV 


mode 

A 


•x*l 


COMPARE CMS 

Compares two existing files on a 
record for record basis and 
displays dissimilar records. 


COMpare fileidl 
options : 



fileid2 


t(optionC)13 


CONUAIT CMS 

Causes the program to wait until 
all pending terminal I/O is 
complete. 


CONWAIT 


COPYFIIE 

Copies files according to 
operand specifications. 


CMS 


COPYfile 


fileidil Cfileidi2. 


3 [fileido3 [(options...[)33 


options : 

Type [NEWDatel [NEUIFi le i 
NOTvpe ^ j^OLDDateJ [REPlaceJ 


I PRompt 
iNOPRompt 
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I CP CMS 

I Permits entry of CP commands 
j without leaving the CMS 
I environment. 

I 

I CPEREP CMS 

I Invokes CPEREP service aid to 
1 process VM/SP error recordings. 

I Requires CP Class C» E» or F. 


CP Ccommandline3 


CPEREP [filename filetype [filemodelx]] 


rUACCC=Y33n [clear 

MACC=N H CLEARF 


|CONTROLLER = (cpuser.-^cuX 


,cua 


cua 

1 

cuX 

fCpuser. 

cuX 

...) 

cua-cua' 


' cua-cua’ 



Notes CCPU = serialno.modelnol f serialno.modelno»...]] 

1. The operands for the CPEREP CCPUCUA=(serial.addr,serial.addrC»serial.addr,...])3 

command cannot be entered on 

the command line. r -i * 

2. Enter operands via prompting ICTLCRD |datel[date2CintervalCtitie...333H 

technique or from file I )datel»Cdate23»[interval3»[title3H 

specified. •- 

‘Operand exclusive to VM/SP. 

*After entering the CTLCRD operand and associated data* no other operands can be entered on the 
same command line; the next operand must begin on a new line. 
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Description 


CPEREP (cont.) 

3. If the TYPE= operand has no 
record type specified, then 
all record types are processed. 

4. Only the privilege class F 
user (usually system support 
personnel or the IBM customer 
engineer (CE)) can erase the 
VM/SP error recording area. 


CCUA=(addr[,addr,...])] 

[DATE=,yrdayC,yrday])3 [DEV=(devtypeC,devtype,...])3 
[DEVSER = (serial!,serial,... 3)3 
CERR0RID=(seqnoCcpuid,asid,hh,mm, ss, t3 )3 



EventC =Y3( 
[EVENT=N3i 

rjHISTC=Y3( 

hHIST=N3i 


LINECT= 

mnn 

50lj 

L 

[! 

“ j 

iMERGE[=Y3il 

|CMER6E=N3H 

L - j 

CLIBADR=addr3 




[MOD=(modelnot,modelno...3)3 


PRINT = (^PS 
PT 

NO 


[iRDESUMC- 
IUrdesum 


=Y3M MSH0RTC=Y3| 
-N3i USH0RT=N3( 
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CPEREP (cont.) 


I SHARE=(cpus«r.<cuX 


[Cua i 


cuX 

. . .) 

fcua-cua) 

. 


^nnnn!) 

riSY5UMC=Y3t 

CTABSE=sizeK3 

)nnnx \ 

kSYSUM=N3S 


\nnxx ( 

L J 



fuERMINALCsY 
I Uterminal=n 


[TERMNstsrmnamQ] 


it«)3 rjTRENDSC=Y3i 
I Utrends=n]J 


C THRESNOLD=(tempread» tampMr 
CTIME=(hhmm»hhmm)3 


CTYPE=CC3[D][E]CH]Cl]Cri]t03CS]CT]3 

CVOLID=(volidlC.volid2C,volid3C,volid4333)3 


riZER0[=Y3n 

|hZER0=il3n 


{'Operand exclusive to VM/SP. 
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Description 


I CPTRAP CP Class C 

j Use to create a file of trace 
I table* and CP and virtual mach- 
j ine interface records in the 
I order they happen for problem 
I determination- The CPTRAP 
1 READER file can be printed out 
i or displayed at a terminal using 
j the CMS module TRAPRED 


! 


Format 


CPTrap 



typenum jVmblok nnnnnnj 
iDEVaddr nnnn j 
code nnnn 
[off j 

STArt fcTOl userid] 

I » 1 


ALL C0N3 
OFF 

ALLOUid userid 

CLOSE 

STOP 
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DCP CP Class C,E DCP 

Displays real processor storage 
on the terminal. 


I 



MLhexlocl 


fhexlocZ 

■ 


NLhexlocl 


bil gm 



MThexlocl 


L J 



NThexlocl 





Mhexlocl 


r 



Nhexlocl 


{.}1bytecount I | 


Lhexlocl 


1 end 

II 


Thexlocl 


L 



hexlocl 



J 


I IL ^ J 

DDR Cns I DDR Cfn ft [fm)j!l3 3 

Dumps, restores, prints, or I 

copies data from DASD devices I I/O definition statements ; 


and tape devices. 

iIMput 1 

cuu type 

volser 


JoUTputi 


altape 


I 


[(options. ..033 


o^ 








IBM VM/SP Quick Guide for Users 


Description 


DDR (cont.) 


set.ions; 

[REUind] fnOde 625ol fsKip nn] 

LEave KOde 1600 I SKio 0 

UNload node «00j -* 


SYSPRINT 
SYsprint 


iDUmp { 
■'copy , 
I REstore 


control statement t 
CcuujCONS] 


statements; 


cyll[T03[cyl2CReorder3ET0]Ccyl3]3 

blocklCT03[block2EReorder3CT03Cblock333 

CPvol 

Nucleus I 

ALL J 


PRIN . T/TYPE tu nction statement? 


[fcyll Chhl Crrl33CTo cyl2 Chh2Err2333C(options...C) 
I IblocklCTo block23 


FhcxI LGraphic3 [Count3 








Summary of VM/SP Commands 






DEBUG CMS 

DEBUG 


1 

Enters the DEBUG environment to 
test and debug a program. 

The format of each DEBUG subcommand follows: 

Stops program execution at 
a specific instruction 
location. 

BReak id |symbol! 

j^hexlocj 


Displays the Channel Address 
Word (CAW). 

CAW 



Displays the Channel Status 

Word (CSW). 

CSW 



Assigns a symbolic name to a 
specific storage address. 

DEFine 

symbol hexloc [ bytocountl 

J 


Dumps the contents of storage 
locations to the virtual 
printer. 

DUmp 

symbol1 symbol2 

hexlocl hexloc2 [ident] 

0 » 

L — 


^The FTR option is valid only with the DUMP control statement. 1 
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ON 

00 


Description 

Format 

DEBUG (cont.) 

Exits from the DEBUG 
environment and begins 
program execution. 

GO 

r symbol 1 

1 hexloc ) 

L J 

Displays the contents of the 
specified general registers. 

GPR 

regl [reg2] 

Returns to CMS environment. 

HX 


Sets a base address. 

ORi g 

in { symbol Ihexloci£} 

Displays old PSU. 

PSM 


Returns to CMS environment 
when DEBUG environment Mas 
entered via DEBUG command. 

RETurn 

Changes the contents of the 
specified register control 

Mord. 

SET 

( CAW hexinfo ) 

) CSW hexinfo [hexinfo] 1 
] PSW hexinfo [hexinfo] C 
\ GPR reg hexinfo [hexinfo] ) 

Stores up to 12 bytes of hexa¬ 
decimal information in the 
specified virtual location. 

STore i symbol i [hexinfo [hexinfoll 
( hexloc ) 

Examines virtual storage 
locations. 


symbol [nllength]| 
hexloc [nj4] i 
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I defaults cmsidefaults 

I Set or display default options I 
I for the commands: FILELIST, NOTE | 

I RDRLIST, RECEIVE, PEEK and I 

I SENDFILE I 

I DEFINE CP Class B iDEFine 

I Redefines the status of a 3330V 
I volume. 


j PEFINE CP Class G 

Reconfigures the user's virtual 
machine or channel operating 
mode. 


DEFine 


Set command options.. 
LIST [command] 


Sysvirt)raddrlC-raddr2] 
Virtual^ 


Reader 

Printer 

PUnch [Aslvaddr 

CONsole 

CTCa 

TIMer 

1403 

1443 

2501 

2540P 

2540R 

3203 

3211 

3262 

3289E 

3505 

3525 

3800 [As] vaddr [Size mm 11] 


CHANels [As] \SEL/ 
]BMX( 


4Wcgml |CF 

S NODatck 

2Ulcam BT 

S DAtch 
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Description 


Format 


DEFINE (cont.) 


Line tAs] vaddr fTELEC2]l 

[IfiMIil j 



vaddrl CAsI vaddr2 



GRAF cuu 

3033 

3036 

3138 

3148 

3158 

3270 




TFB-512 

T3310 [As] vaddr CBLKI [nnnnnn] 

T3370 


1 

T2305 

T2314 

T2319 

T3330 tAsJ vaddr CCYL3 CnnnI 

T3340 

T3350 

T3375 

T3380 


STORage tAs!I 


nnnnnK 

nnfi 
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Description | Format 


DETACH CHANNEL CP Class B |DETach CHANnel c CPROC nn] [From] (useridlx) 

Removes the specified channel andj 
all its related devices from j 

the specified user. j 


DETACH CHANNEL CP Class G DETach CHANnel c 

Detaches the specified channel 
from your virtual machine. 

DIAL CP Class Any DIAL userid Cvaddrl 

Attaches a terminal device to a 
multiple access system. 


DIRECT CMS 

Allows creation^ editing, and 
swapping of VM/SP user directory. 


DIRECT 

fn 

Fft 

fm 


[(EDIT)] 


USER 

[DIRECT 





L L 1 



- 


Control statements : 

Account number [distribution] 

Console cuu devtype [class] 

Dedicate cuu (rdev|[VOL ID] volser)[R/0][3330V] 

DIRectory cuu devtype volser 
Ipl iplsys 

Link userid Idev [cuu [model] 

Mdisk cuu devtype Jcylr cyls volser [modelprCpwEpm]]]] 
h-DISK cyls 
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DIRECT (cont.) 


DISABLE CP Classes A,B 

Prevents communication lines from 
accessing VM/SP. 


DISCOMN CP Class Any 

Disconnects the terminal from 
VM/SP system Mhile virtual 
machine continues operation. 


DISCONN RSCS 

Disconnects the RSCS operator’s 
terminal from VM/SP while the 
RSCS virtual machine continues 
operation. 


Option Realtimer Ecmode Virt=Real Acct Svcoff BMX 
CPUID bbbbbb AFFinity nn Isam VMsave STFirst 370E Maxconn nnnn 
SPEcial cuu devtype ClBMlTele] 

Spool cuu devtype [class] 

User userid pass Cstor Cmstor Ccl Cpri 

r r r mn 

]]]] 


le 

Id 

cd 

es 

111 

ON 

ON 

ON 

ON 

1 

OFF 

OFF 

OFF 

OFF 

1 

j j j 


DISAble 


i raddr... 
SNACuserid] 
ALL 


DISConn [HOld] 


DISConn [userid] 
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i PLBL CMS DLBL 

1 In CMS/DOS, defines DOS and CMS 
I sequential disk files for program 
I input/output; identifies DOS 
I files and libraries; defines 
and identifies VSAM catalogs^ 

I clustersf and data spaces; 

I identifies VSAM, DOS, or CMS 
I files used for VSAM program 
I input/output and access method 
I service functions. 


i In CMS, defines and identifies 
I VSAM catalogs, clusters, and 
I data spaces; identifies VSAM 
j files used for program input/ 

I output; identifies input/output 
I files for Access Method Services. 


ddname 

Jmode i 


iDUMMYi 

ddname 

imode ( 


/DUMMY\ 


ddname CLEAR 

I 

L 


[cMS fn ft [(optionA optionBC)]] 

[CMS FILE ddname 

DSN quail C.qual2...qualn] 

DSN quail [qual2...qualn] 

DSN ? 

CCoptionA options optionC [)]] 


optionA : optionB ; opi?ionC; 

CSYSxxx] [PERM] [VSAM ] 

[ change 1 [extent] 

INOCHANGEI MULT | 


[CAT catdd] 
[BUFSP nnnnnn] 
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Summary of VM/SP Commands 


In CMS/DOS, link-edits TEXT files 
from CMS disks* or object modules 
from DOS/VS private or system optiona 

relocatable libraries* and places r 
them in executable form in a CMS DISK 
phase library (DOSLIB). PRINT 

TERM 


DRAIN CP Class D | 

Stops spooling activity on the | 
specific device after the current! 
file is finished spooling. j 


I 

CP Class D iDRain {Reader I 
ivity on the j jPrinter j 


punch 
raddr.. . 
AU 


DRAIN RSCS DRain tlinkid] 

Deactivates the specified link 
I after the current file processing 
I is completed. 

I DROPBUF CMS DROPBUF n 

Eliminates the most recently 
I created program stack buffer 
j and all buffers created after it. 
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DUMPSCAN (cont.) 

Displays last subcommand 
entered. 

7 

Displays the registers^ 
clocks, PSkI, CSM, and CAM 
for attached processor. 

Aregs 

Displays the control registers. 

C 

Displays areas in the dump. 

Display ihexloc [ Cnnnn] or Display jThexloc ( Cnnnn] 
(hexlocXi nhexloc^i 

Locates the CP module that 

includes the address hexloc, 

displays its current loaded 

address and displacement of 

hexloc. 

DMK? hexloc 

Lists load map address and 

real address for module mmm, 1 

entry name ee. 

DMKmmmee 

1 

Ends and returns to CMS. 

END 

Displays the general registers. 1 

G 

Displays a summary of 
subcommands. ! 

HELP 
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Format 


HX 

Locate string fromhexloc tohexloc [increment] 

MAP 

Mregs 


Print 

PRT 

— or — 

Print subcommand 
PRT ON 
OFF 
CLOSE 

7 


QUIT 

Regs 
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Description 

Format ] 

EDIT (cont.) 

’ 1 
The EDIT subcommands and macros are: i 

Duplicates the current line. 

This is a macro. 

$DUP Cilnl 


Moves n lines up nj or down in 
lines. This is a macro. 

$M0VE n iUp m | 

^Down m > 

/to label) 


Displays the last executed EDIT 
subcommand except for the 
REUSE(=) or ? (question mark) 
subcommands. 

7 


Scans Q records* altering the 
specified character. 

Alter Chari charZ [nfo 

[ih 


Saves the file after the 
indicated number of changes or 
displays the current setting. 

1 AUTOsave CniOFFl 


Repositions the current line 
pointer toward the top of the 
file. 

1 BAckward Clin] 



Moves the current line pointer 
to the last line of the file. 


Bottom 
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EDIT (cont.) 

Translates to uppercase. 

CASE CUlMl 

Changes stringl to string2. 

Change C/stringlC/5tring2[/ n G 111 

11 

Enters CMS subset command mode. 

CMS 

Deletes n lines or to EOF. 

DELete [n|il»<l 

Moves the current line pointer 
to the nth line down from 
the current line. 

DOwn [nil] 

Deletes lines from the current 
line down to (but not 
including) the line that 
contains the designated string. 

DString /CstringC/]] 

Saves the file edited on disk 
and returns to CMS mode. 

FILE Cfn [ft Cfm 1)] 

Searches the file for the 
specified line. 

Find [line] 
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Description 

Format 

EDIT Ccont.) 

Resets or displays the 
filemode. 

FMode [fm] 



Resets or displays the 
filename. 

FName [fn] 



Changes the mode of displaying 
data on a 3270 terminal from 
typewriter (line) style to 
full-screen display style or 
vice versa. 

FORMat CDISPLAYlLINEl 



Moves the current line pointer 
forward n lines. 

Forward tilnl 



Inserts some or all of the 
specified file. 

Getfile |fn| ft F fm 

P firstrec 

numrec 1 I P 

J j j J 

Expands text (including back¬ 
space and tab) into line images 
or displays current settings. 

IMAGE tON|OFF(CANON]2 



Inserts a line into the file 
or enters input mode. 

Input [line] 
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EDIT (cont.) 

Sets or cancels line-number 
editing, or displays current 
setting. 

r 1 

LINEmode I LEFT|RIGHT|OFF ^ 

IL IR 1 

L 

Scans the file for the first 
occurrence of a string. 

[Locate]|/[stringC/]3 

Enters LONG error message mode. 
LONG is the default mode. 

LONG 

Advances the current line 
pointer n lines toward the end 
of the file. 

Next Cnjl.] 

Replaces all or part of the 
current line. 

Overlay [line] 

Saves current mode settings. 

PREserve 

Sets the line increment for 
line-number editing. 

PROMPT [nlifi] 

Terminates the EDIT session 
leaving the previous copy of 
the file intact. 

QUIT 

1 

[^Operands are positional. 

I^ON is the default for all filetypes except SCRIPT. CANON is the default for SCRIPT files. 

1 ^Line-number editing is the default for U5BASIC and FREEPORT files. 
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Description 


Format 


EDIT (cont.) 

Sets or displays record format. 

RECfm 

CFIVI 

incrnoIi 
strtnoJJ 

Recomputes line numbers. 

RENum 

1strtno1 

L ^ L 

Executes the following OVERLAY 
request n times or to EOF. 

REPEAT 

Cnlil*] 


Replaces the current line with 
'line' or deletes the line and 
enters input mode. 

Replace 

[1inel 


Restores mode settings. 

REStore 



Returns to EDIT environment. 

RETURN 



Stacks (LIFO) the last EDIT 
subcommand and executes the 
stacked subcommands. 

|REUSE| 

[subcommand] 

Saves the file on disk. 

SAVE Cfn Cft Cfm 111 

Displays a number of lines 
above or below the current 
line. 

iScroll i 

{sCcrolllUCp]i 

txlnlil 
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EDIT (cont.) 


Turns serialization on or off 
in columns 73-80. 

Enters SHORT error message 
mode. 

Stacks n lines in the terminal 
input buffer. 

Sets the specified tabs. 

Moves the current line pointer 
to the beginning of the file. 

Sets or displays the column of 
truncation. 


Displays the specified number 
of lines beginning with the 
current line. 


00 


Points to the line n lines 
above the current line. 


I 


SERial (OFF r t 
3 ON Iincr| 

) ALL I 10 I 
I seq •- -* 

SHORT 

STACK Cn ill 0 I subcommand] 

TABSet nl [n2 ... nn] 

TOP 

TRUNC Cn|M] 



Up Cnll] 
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Description 
EDIT (cont.) 

Sets, displays, or resets 
verify mode. 


Assigns to X or Y the given 
EDIT subcommand. 


Sets or displays the columns 
to be edited. 


Locates the line when using 
line-number editing. 


ENABLE CP Classes A,B 

Activates communication lines. 


ERAS E CMS 

Deletes files from a user’s 
di sk. 


Verify ON startcol ended 

OFF i a 


i Xi [ subcommand i n il.] 

y! 

Zone firstcol lastcol 
1 


ENable \ raddr. . . 

< SNAtuseridl 
(ALL 


fnMft([fm] [(optic 


options : 

C T vpeI Nol 
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ESERV CMS 

In CMS/DOS, copies edited DOS/VS 
macros from system or private 
source statement E sublibraries 
to CMS disk files; or lists de¬ 
ed i ted macros. 

ESERV fn 

EXEC CMS 

Invokes EXEC files. 

[EXec] fn Cargs... 3 

The formats of the EXEC control statements are: 

Assigns a variable. 

Svariable = (ae1stringIfunction|X'xxxxxx) 

Defines or redefines arguments 
to special variables 81-430. 

8ARGS [argl [arg2 ... Carg30]]3 

Displays the following 
unscanned error message lines 
at the terminal. The list of 
lines to be displayed must 
end with an 8END control 
statement. 

8BEGEMSG CALL]^ 

Punches the following lines 
into cards. End the list of 
lines with an 8END control 
statement. 

8BEGPUNCH CALL] 

1 

1 ^See the 8EM5G statement for the format of message lines. 1 

1 
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EXEC (cont.) 

Exits from the EXEC file with 
a specified return code. 

Transfers control to a 
specified location. 

Initiates or terminates hexa¬ 
decimal conversion in an EXEC 
procedure. 

Allows statement execution if 
the comparison is satisfied. 
If the comparison is invalid# 
execution continues with the 
statement following the tIF 
statement. 

Describes a loop in an EXEC# 
and conditions for exit from 
the loop. 

Punches a card with the 
yo j specified tokens. 


4EXIT Creturn-codelO] 


&G0T0 {TOPI line-numberl-label) 


«HEX CON I OFF) 


S;IF itokl) operator itokZ} executable-statement 

\n i 1 


tLOOP } n Mm 

/-label i (condition 


iPUNCH Ctokl Ctok2 ... Ctoknl]] 
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Description 


Format 


EXEC (cont.) 1 

Reads the next line (or lines) j 
from the terminal stack. 1 

&READ 

n 

ARCS 

VARStJ;varl[»var2 ... 
i 

C&varn]]] 

1 

Skips subsequent statements. | 

4SKIP 

Cnil] 


Displays blank lines at the 1 

terminal. j 

«SPACE 

Cnlil 


i 

Places a line of tokens in the i 
console input stack. 1 

1 

iSTACK 

FfIFoI rtokl[tok2 ... 

ILIFO HT 

1 . 

ttoknuj 

J 

1 

Displays time information on | 

the terminal after each CMS j 

command is executed. 1 

j 

4TIME 

CONlOFFiRESETiTYPEl 


I 

Displays the specified tokens | 
at the terminal. j 

JITYPE 

Ctokl ttok2 ... Ctoknll 

1 

1 

j 

The formats of EXEC built-in 

functions are: 

Concatenates tuio or more tokens! 
and assigns the result to a j 
variable symbol. 1 

^variable = iCONCAT tokl[tok2 

... [toknl] 
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EXEC (cont.) 

Determines whether the 
specified token is 
alphabetic or numeric. 

^variable = 

SDATATYPE token 


Indicates number of nonblank 
characters in the specified 
token. 

^variable = 

SLENGTH 

token 


Allows the use of the literal 
value of the token without 
symbolic substitution. 

tLITERAL token 

[...] 


Extracts a character string 
from the specified token. 

Invariable = 

SSUB5TR 

token i 

Cj] 


The formats 

of EXEC 

special 

variables are: 

Represents the numeric 
variables &1 through &30. 

&n 




Used to perform a collective 
test on all arguments passed to 
EXEC. 

tn and 




Contains the filename of the 
EXEC file. 

SO 








94 IBM VM/SP Quick Guide for Users 


Description 

* Format 

EXEC (cont.) 

Used to determine whether a 
disk is an OS, DOS, or CMS 
disk. 

«DISKx 


Contains the mode letter of the 
first read/write disk in the 

CMS search order (or contains 
the word NONE). 

«DISKX 


Determines which of the user’s 
accessed read/write disks has 
the most space. 

&DISK? 


Indicates the current status of 
the CMS/DOS environment (ON or 
OFF). 

«D0S 


Indicates the filename of the 
EXEC file. 

4EXEC 


Indicates the recursion level 
of the EXEC procedure that is 
currently executing (maximum - 
19 levels). 

&GLOBAL 


Represents the numeric 
variables 4GLOBALO through 
«GL0BAL9. 

SGLOBALn 
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EXEC (cent.) 


Indicates the number of argu- 

tINDEX 

ments passed to the EXEC pro- 


cedure (maximum - 30). 


Indicates the current line 

&LINENUM 

number in the EXEC file. 


Indicates the word STACK if 

AREADFLAG 

there are lines stacked in the 


terminal input buffer, or the 


word CONSOLE if a read is to be 


issued to the terminal. 


Indicates the return code from 

tRETCODE 

the most recently executed CMS 


command. 


Indicates either the RT 

4TYPEFLAG 

(resume typing) or HT 


(halt typing). 


EXEC £ CMS 

EXEC filename Cargl targ2 ... argn]] 

Invokes EXEC 2 files. 



The formats of the EXEC 2 predefined variables are: 

Initializes to its own name. 

1 

This variable is initialized or 


maintained automatically. 






IBM VM/SP Quick Guide for Users 
























Summary of VM/SP Commands 


EXEC 2 (cont.) 


Evaluates true date (primary 
meridian — GMT) in the form; 
YY/MM/DD. (S^ also STIME, 
beloM.) 

4DATE 

Keeps number of user-defined 
function and subroutine 
invocations to which return 
not yet made. 

&DEPTH 

Initializes to third qualifier 
of EXEC 2 file. 

4FILEM0DE 

Initializes to first qualifier 
of EXEC 2 file. 

4FILENAME 

Initializes to second qualifier 
EXEC 2 file. 

4FILETYPE 

Initializes to zero and keeps 
line number of last executed 
S60T0 statement of EXEC 2 file. 

4FR0M 

Keeps current line number of 
EXEC 2 file. 

4LINE,4LINENUM 

Keeps line number of currently 

&LINK 

executing usei—defined function 
or subroutine invoker or is 



M5 

•vj 


zero. 
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Description 


Format 


EXEC 2 (cont.) 

Keeps the number of EXEC 2 SN,ftINDEX 

arguments set. ( See SI, S2, 

... Sn, above.) 

Initializes to zero, and keeps SRC,SRETCODE 
return code from last EXEC 2 
issued command or subcommand. 


Evaluates true time-of-day STIME 

(primary meridian -- GMT) in 
the form; HH;MM:SS. ( See 
also SDATE, above. 

The formats of the EXEC 2 control statements are; 


Assigns Mordl, word2, ... 
wordn to arguments SI, S2, ... 
Sn and discards previously set 
arguments. 

Prints linel, line2, ... linen, 
truncated at column k if 
necessary. Does not remove 
surplus blanks or replace any 

EXEC 2 variables. 


SARGS [Mordl [Mord2 ...]] 


SBEGPRINT 

SBEGTYPE 



1 i nel 
line2 
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^lil^ mi-. 





EXEC 2 (cont.) 

Places linel> Iine2> ... linen# 
in the console stack# 
truncated at column k if 
necessary. Does not remove 
surplus blanks or replace any 
EXEC 2 variables. 

SBEGSTACK 

n [k [fIFoII 

X |x iLIFOl 

L- L JJ 

label 




1 i nel 
line2 




Discards lookaside buffer and 
its contents# then creates a 
new lookaside buffer for either 
designation. 

SBUFFER n 

[comment] 



Invokes the routine located at 
the specified label or line 
number and creates a new 
generation of the EXEC 2 
arguments SI# S2# ...# Sn 
initialized to argl# arg2# ...# 
argn. Control is returned via 
the SRETURN statement. 

SCALL line-number [argl [arg2. 
label 

,.]] 
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Description 

Format 

EXEC 2 (cont.) 

Translates any louiercase 
alphabetic character to upper- 

tCASE [u [comment]] 

L" J 

case or allouis mixed cases. 

If U or M is not specified^ the 
current setting is not changed. 


Issues the command comprising 
the word operands^ each with 
one space between. 

4C0MMAND wordl Cword2 ...I 

Aids debugging the EXEC 2 in¬ 
terpreter DMSEXE. Intended to 
to be used by system support 
people only. 

4CRASH [text] 

Note; An asterisk (*<), a 
hyphen (-), or an ampersand (4) 
starting a command must be 
given as an argument. 


Prints a line for each 41, 42» 
...» 4n argument or variables 
vari» var2» ...» varn. 

4DUMP ARCS 

VARCS] tvarl Cvar2 ... 11 
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EXEC 2 (cont.) 

Sets the action to be auto¬ 
matically invoked on return 
from any command(s) or sub- 
command(s) that has a nonzero 
return code. 

Stops execution of the EXEC 2 
file and yields the given 
numeric return code within the 
host system acceptable range. 

Transfers control to the 
designated line number or to 
the line with the label. The 
first character of label must 
be a hyphen. 

Executes the given executable 
statement if the condition is 
satisfied; otherwise^ proceeds 
to next statement. 


&ERR0R action 


4EXIT 


return-code [comment! 
0 


&GOTO line-number [comment! 
label 


&IF wordl 


= |EQ 

-=|NE 

<=|LT 

<=|->|LE|NG 

>|GT 

>=|-<|GE|NL 


[Mord2 executable statement! 
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Description 

Format ] 

EXEC 2 (cont.) 

Loops through the designated 
operands until specified 
condition is satisfied. 

Note; When condition is given# 
the operands are the same as 
given in the 4IF statement. 

4L00P 

n m 

label X 

WHILE condition 
UNTIL 


Presumes that any statement 
without a beginning ampersand 
is to be issued to CMS or to 
the designated subcommand 
environment. 

^PRESUME l«C0MMAND 1 

^SUBCOMMAND environmentj 

Prints or types a line 
containing the operandCs) each 
separated by one blank or 
prints or types a blank line if 
no operand appears. 

4PRINT twordl Cword2 ,..11 

8TYPE 


Reads from the stack (if stack 
is not empty); otherwise# reads 
from the console the number of 
lines indicated# or assigns 

SREAD 

n 

1 

¥ 

ARCS 


values as designated. 


VARCSI tvarl Cvar2...33 




STRING var 



\ 
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I 
I 

o 

04 


EXEC 2 (cont. ) 

Returns control to the most 
recently invoked subroutine to 
which no return has as yet been 
made. 

Skips the designated number of 
lines dependent on whether it 
is a positive or negative 
number. If it is equal to 
zero, control goes to the next 
line. If it is negative, 
control goes to the statement 
that precedes the iSKIP state¬ 
ment . 

Stacks a line that contains 
word(s) that are separated by 
one space or stacks a null line 
if no words are given. 

Issues the designated 
subcommand comprising word(s) 
separated by one space to the 
appropriate environment. 


^RETURN [word] [comment] 


iSKIP 


«STACK 


[comment 


j1 

J 


FIFO [wordl [word2 ...]] 
LIFO 


ftSUBCOMMAND environment [wordl [word2 ...]] 
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Description 
EXEC 2 (cont.) 

Traces commands and subcommands 
as indicated by the trace 
setting. Information obtained 
is passed to the destination 
determined by output action. 


Note : Initial trace setting is 

OFF. Default is asterisk 
which means ci'rrent setting 
remains in effect. Initially, 
output action is set to &PRINT. 

Sets the truncation column to k 
or the maximum value (><) . If 
no argument is shown, the 
previous setting stays in 
effect. 

Translates any lowercase 
alphabetic characters to 
uppercase in the values of &!, 
42, ... 4n or the values of 

varl, var2, ..., varn. 




Format 


ON output-action 

ERR 

ALL 

OFF 


4TRUNC Ik 



4UPPER ARCS 

VARCS] [varl Cvar2 ..,]] 
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1 

1 

Concatenates the word(s) with j 

^CONCATENATION OF Twordl 

word2 ... 

1 

no intervening space into a j 

i 

iCONCAT 1 

L 



EXEC 2 (cont. ) 


iThe formats of the EXEC 2 predefined functions are: 


single word. If no word(s) 
appear, a null line results. 


Yields the value NUM if word 
represents a valid signed or 

unsigned number; otherwise, thej 
value is CHAR. 

Yields a numeric value 
representing the integral part j 
of the division of the dividend! 
by the divisor. 

Left-justifies word of length 
j. Truncates or pads with 
blanks on the right-hand side. 

Gives either the number of 
characters in word or zero if 
word is not given. 


^DATATYPE OF (word 
JTYPE 


^DIVISION 

XDIV 


OF dividend divisor 


JLEFT OF word j 


^LENGTH OF [word] 






106 IBM VM/SP Quick Guide for Users 


Description I 

Format 



EXEC 2 (cont.) j 

Gives the literal string 1 

beginning with character after j 
blank following OF and ending 1 
with the last nonblank 1 

character. | 

JiLITERAL OF [string! 



Note: Any leading or embedded j 
blanks are retained and search j 
for replacement variables is | 
suppressed. I 




Searches word for first j 
occurrence of char(s) and gives! 
the starting position numberf j 
or a zero when there is no I 
matching string, or char(s) j 
exceeds word length, or a word j 
is not given. j 

^LOCATION OF needle [haystack! 


Yields numeric value that j 
results from the multiplying ofj 
given numeric signed or j 
unsigned words. 1 

^MULTIPLICATION OF i j 
«MULT 

k. . . 

1 

1 

Note; There must be at least 
two of these. 1 
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Description I 


EXEC 2 (cont.) I 

Right-justifies Mord of length 1 
j. Truncates or pads with j 
blanks on left-hand side. 1 

«RIGH 

Gives the string beginning with! 
character after blank following! 
OF and ending with last j 
nonblank character. 

4STRI 

Compares each character in 
wordl with word2. If a match 
if found, the position of that 
matching character in wordl is 
replaced with the character in 
the same position from word3. 

«TRAN 

4TRAN 

If word has trailing blanks, j 
removes them. If word is not | 
given, result is a null line. I 

4TRIM 

Gives the nth word in the list j 
of words unless the number j 
given is zero or exceeds the j 
number of words in the list. 1 

iktORD 
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I EXEC 2 (cont.) 

Invokes the.given function by 
transferring control to the 
given line number or label and 
creates a neia generation of 
EXEC 2 arguments Sl> iZ, ... &n 
initialized to argl^ arg2» ... 
argn. Control is returned via 
the 4RETURN statement. 

l EXEClO CMS 

I Do I/O operations betioieen a 
I device and the program stack. 



I The format of the EXEC 2 User—Defined functions 

line—number OF fargl arg2... 1 
i label J 


DISKR fn ft [fm Clinuml] CCtFINIsl 

options Cal Cbl] [)] 

CARD [( options Cal [bl] [)] 

CP [( options £al Cbl Id]] [)] 

DISKW fn ft fm Clineum 

Crecfm [Irecl]]] CCCFINIsl 

options Cbi Cel Id]] [)] 
PUNCH CC options Cbl CcI Cdll 03 

PRINT fcTcC CCODElloptions Cb3 Cc3 Cd3 
I I CDATAll 


options Cbl Cc] Cdll 03 
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EXECIO (cont.) 


Option formats: 
(a) 


(b) 


(c) 


(d) 


Find /chars/ 
LOcate /chars/ 
Avoid /chars/ 
Zone ini n2( 

IL il S 


Margins 

STRIP 

NOTYPE 


ii‘ f I 


151 


STring xxx... 


LIFO 

FIFO 

SKip 

Note: Parsing of the EXECIO command differs from that of other CMS commands in that it 

involves handling of strings that may contain embedded blanks, parenthesis, other special 
characters, and words of more than eight characters. Therefore, if a right parentheses is used 
to mark the end of an EXECIO option, it must be preceded by at least one blank character. 

A right parenthesis cannot be used to mark the end of the STRING option. 


Description I Format 

- j- 

EXTERNAL CP Class G lEXTernal [code I 10 ] 

Simulates an external interruption! 
condition on the virtual machine | 
and returns control to that I 

machine. j 
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I 


FEEDBACK 

Places comments about the opera¬ 
tion of the system and/or the 
Programmable Operator in the 
feedback file. 

FETCH CMS 

Loads an executable phase into 
storage for execution. 


I FEEDBACK text... 

IFB 

I 

I 

I 

I 

iFETch phasename [(options...[)J] 
I opt ions : 

I[START] 

1[COMP] 

I[ORIGIN hexloc] 


I 

FILEDEF CMS iFIledef 

Simulates OS JCL (Job Control 
Language) data definition (DD) 
statements. Displays current 
definitions uhen entered without 1 
operands. I 

I 
I 
I 


|ddname//Terminal 
.nn I 

x ) PRinter 

punch 
Reader 


[(optionA 

[(optionA 
[(optionA 


DISK Ifn ft 

I FILE ddname 
or 


optionDC)3 3 

OPTCDt)]] 

[)]] 





DISK fn ft 

fm 

DISK FILE ddname 

M 

. 

. 


I \DSN ? iI 
I 1DSN quail qual2. . .U 
I f DSN QUALl.qual2...\ I 
I [(option A optionB[)]] I 


optionBC)]] 
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Description 

Format 

FILEDEF (cont.) 



'dummy E(optionAE)]] 


! 



TAPEn] 

LABOFF 

BLPCn] 

SLEn] EVOLID volid]EDISPM0D] 
SULEn] EVOLID volid] 

NSL filename 

NLEn] 


1 



GRAF 

cuu [(optionA optionC optionEE)]] 

cuu" [(optionA E)]] 

1 

1 

j 

L 

.CLEAR 


f 


optionA: CPERM] [ CHANGE INQCHANGE] 

ERECFM {FjFBlViVBlUlVSIVBSIFSIFBSIAIM}] 
tLRECL nnnnn] C(BLOCKIBLKSIZE) nnnnnl 


optionB: CKEYLEN nnn] E XTENT (nnnnnlSO}] ECONCAT] 
ELIMCT nnn] COPTCD {[A3EE3EF3EJ3ER]} 
EDISP MOD] [MEMBER membername] 

EDSORG (PS IPO I DA}] 


optionCt E7TRACKI9TRACK3 ETRTCH (0 IOC|OT|E|ET}] 
EDEN {200i556i800|1600i6250}] 


optionD: E UPCASE lLOUlCASE] 


optionE: [LEAVE] 
ENOEOV] 
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FIL E L IST CMS 

I Lists information about CMS disk 
I files» with the ability to edit 
and issue commands from the list. 


FINIS 

I Closes one or more file 


FILEList Cfn [ft Cfm]]] C(options...[) 
options; 

[Append] 

[Filelist I Nofileiist ] 

[PROFile fn] 


FLUSH CP Class D Flush raddr CALL] CHOld] 

I Halts and immediately purges or 
I holds the current spool file. 


Stops and deletes the current 
file from further processing. 


RSCS {Flush Clinkid] CspoolidjM] [ALL][H01d] 
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FORMAT/ALLOCATE (cont.) 


I* Label Function 

I FORMAT t devadr> devtype,volser» LABEL 


I FREE CP Class D 

I Releases previously held user 
I spool fi les. 


I FRee userid Printer 
I punch 

I Aii 


FREE RSCS 

Causes I/O transmission on a 
particular link to resume. 

FMDSPACE RSCS 

Causes the file currently being 
processed to be repositioned 
in a forward direction. 

I GENDIRT CMS 

' Creates auxiliary module 
directories. 


FRee LlinkidKnnn] 


FUdspace C1inkidlCnnn1 


I GENDIRT directoryname CtargetmodeCsourcemode]] 
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I 


GENMOD CMS 

Generates a nonrelocatable 
(MODULE) file on a CMS disk. 


GEN3705 CMS 

Invokes 3705 Stage 2 service aid. 


GEI 

Retrieves one of the Programmable 
Operator files: the feedback file 
(FB) or the log file (LOG). 

GLOBAL CMS 

Specifies CMS or CMS/DOS 
libraries to be searched for 
macros^ copy files^ subroutines, 
or DOS executable phases ujhen 
processing CMS commands. 


Genmod Cfn [MODULE CfmlAi^^] [(options...!) 


options : 


nomapI 

[sTR 1 [FROM 

entryl] [SYSTEM] 

OS 

MAP J 

iNOSTRi 


DOS 

«- J [TO 

entry2] 

ALL 


GEN3705 fn ft [fml [(options...!)]] 
options : 

[RUN I NORUN ][SAVE! NOSAVE ] 

GET [FEEDBACK ) 

(LOG [yymmdd]) 


GLobal 


rMACLIB ) 
jlXTLIB \ 
\D0SLIB ( 

(loadlib; 


[1ibnamel 


1ibnameS] 
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Desert ption 


GLOBALV Cr' 

Set, maintain, and retrieve a 
collection of named variables. 


INIT 

SELECT 


group 

UNNAMED 


SELECT]group 

?UNNAMED 


SET \ 

SETS<<namelCvaluel]rname2 value2] . . . 
SETP/ 

SETL ( ] 

SETLS\ ( 

SETSL<name Cvalue3> 

SETLPi \ 

sETPLf ; 


Note; Although this command may 
be used in CMS EXECs, it is de¬ 
signed for use with EXEC 2 EXECs. 
Restrictions/precaustions are 
listed in "Usage Notes for the 
CMS EXECs”. 


LIST Cnamel [name2]...] 


SELECT 


I STACK inamel Cname2]... 
J stackr} 
igroup /PURGE 
/UNNAMED] 


GRPLIST 

GRPSTACL 

PURGE 


HALT CP Class A 

Stops any active channel program 
on the real device specified. 


HALT raddr 
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HB CMS Immediate Command 

Halts the execution of CMS 
batch virtual machine at the 
end of the current job. 

HELP CMS 

Displays descriptions» formats, 
and parameters of CMS and CP 
commands and EXECs, and 
description of CMS and CP 
messages. 


HO CMS Immediate Command 

Halts the current CMS tracing 
operation. 

HOLD CP Class D 

Defers processing of specified 
spool output. 


Help 


Help 

message 

MENU 

component MENU 


component 

CMS 


{name!(optionC)]]}j 


options ; [ALL I FORM!PARMiDESC] 


HO 


HOld userid [Printer|PUnch|ALL] 
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Descr 1 ption 


Format 


HOLD RSCS 

Suspends file transmission 
temporarily for a particular 
link. 

HI CMS Immediate Command 

Halts displaying at the terminal. 

HX CMS Immediate Command 

Halts execution of the current 
CMS command or program. 

IDENTIFY CMS 

Display or stack userid, nodeid, 
rscsid, date, time, time zone and 
day of week. 


HOld Clinkid] IMMED 


IDentify [(options. 


STACK [ FIFO l 

FIFO 

LIFO 

TYPE 
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I IMAGELIB CMS 

I Reads control file created by 
I GENIMAGE and loads files into the 
I specified named system. 

\ IMAGEMOD CMS 

I Allows changes to the 3800 named 
I systems. 


INCLUDE CMS 

Brings additional TEXT files 
into virtual storage. 


IMAGELIB namedsys 


IMAGEMOD \GEN/ 1ibnameCmodnameCmodnamel..]} 

KADD^ 

(rep) 

DEL libname membernamel Cmembername2...I 
MAP libname C(optionsC)3] 

options : TERM 
PRINT 
DISK 


INclude fn... C(options...C)33 
options: 


[NOCLEARJ [ 


1 [origin 

ihexlocll 

1 i 

Urans n 

J L 

J 

1 [map 1 

[nOINvI r 

1 1 NOMAP 1 

IINV 1 

J L J 

L - L 
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lABELDEF CMS LAbeldefU » ( CLEAR | 

Specifias standard HDRl and |{filenama( CFID{?|fid)][VOLID volid3 

EOFl tape label description | CVOLSEQ volseqlCFSEQ fseq] | 

information for CMS^ CMS/DOS, (CGENN gennlCGENV genvl >| 

and OS simulation. I CCRDTE yydddlCEXDTE yyddd] | 

[SEQ {£1113)3 

I \C(options. . . 033 I 

L ' J 

options: 

[PERM) [ change 1 

^NOCHANGEJ 

LINK CP Class G LINK CTo3 userid vaddrl CAs3 vaddr2 [model [[PASS=3 password! 

Permits one user to access mini¬ 
disks belonging to another user. 
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Description 


Format 

LISTDS CMS 

LISTDS Idsnamel 

fm( [(options...[)33 

Displays information about data 

1 ? 1 


sets» files» extents» -or free 

L J 


space. 

options: [free 

[FORMAT] 


1 EXTENT 

L J 

[PDS3 

LISTFILE CMS 

Listfile [fn [ft [fm]]! C(options...C)3] I 

Lists information about CMS 

1 X 1 ) 

^11 

files. 


L J J J 


options: 

[Header|NOHeader][ExecC T race][Args3 3|T raceCArgs]|APpendCArgs3 


IStackCFifolLifo]iFifolLifo] 


[Blocks] [ %x 3 


[FName1FTvoeiFMode1FOrmat1ALloc1Datel Label 3 

LISTIO CMS 

LISTIO (sYS ) 


Displays a list of current 

\PR0G / 

[(options...[)]] 

assignments for system and/or 

ySYSxxxV 


programmer logical units in a 

V i 


virtual machine. 

/UA \ 



Iall ; j 

options: 1 

[EXEC 1 APPEND] [STAT3 I 

1 
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LKED 

Used to create a CMS 
LOADLIB or LOADLIB member. 


I LOAD CMS 

I Brings TEXT files into storage 
I and establishes links. 


LKED fn [(options...[)]] 
options : 

[NCAL] [LET] CALIGN2] CNE] COLl [RENT] 

[REUS] [REFR] COVLY] CXCALl L TERM lN0TERM3 
[NAME membername] [LIBE librarynamel 
[XREFIMAPI LIST ] CPRINT I DISK I NOPRINT 3 

[SIZE (valuel valueZ i valuel ) valuelf | »value2 I t 

LOAD fn ... [(options...[)]] 
options ; 

CLEAR ] [reset ientry^l [nOMAp] [nOINv] [nOREp] [START] 
NOCLEARJ [ < ^ ij [MAP J [INV J [REP J 

[type 1 [noAUToI [nOLIBeI [origin VhexlocH [nODUp] 
i NOTYPE i l AUTO j I LIBE j {TRANS (I IjDUP I 


LOADBUF CP Class D LOADBUF 

Loads UCS (Universal Character 
Set) buffer or FCB (forms control 
buffer) on real printer. 


iraddr UCS name [Fold] [Ver] 
(raddr FCB name [Index [nn]] 
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I LOCATE CP Class C, E 

I Provides the addresses of CP 
I control blocks related to a 
I specified user# virtual device# 

I or real device. 

I 

i lOCK CP Class A 

I Locks specified pages in 
I processor storage. 


Mrites a message to the current 
day's log file. 

LOGOFF CP Class Any 

Terminates a terminal session. 

LOGON CP Class Any 

Initiates all virtual machine 
operation. 

MACUB CMS 

Creates and updates macro 
libraries. 


Locate iusendlvaddrJ( 
iraddr > 


LOCK firstpage lastpage [MAPI 

JSYSTEMi 


LOG text... 


userid IpassMord] [Noipl] 


MAClib ( \6EN/ 

\ jADDr libname fnlIfnZ...] 

\ DEL libname membernamelCmembernameZ 
I COMP libname 

f MAP libname (options... ) 


options ; 

UmSK PRINT I TERM! 
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Description Format 

tIAKEBUF CMS MAKEBUF 

Creates a neM buffer uithin the 
program stack. 

( MESSAGE CP Classes A and B Message {ALLtuseridjxjOPerator) msgtext 

Sends text messages to other MSG 

users» system operator or self. 

( MESSAGE CP Class Any Message {userid|x|OPerator} msgtext 

Sends text messages to other MSG 

usersy system operator or self. 

MIGRATE CP Class A MIGrate Cuseridl 

Activates normal page/swap table 
migration routines or forces the 
pages of the specified user to a 
secondary device when the user is 
currently active. 

MODMAP CMS MODmap fn 

Displays a MODULE file load map. 

MONITOR CP Classes A and E MONitor (Display tlPflOLlTAPElALL! 

Starts or stops the recording of ) 

interruptions and other events )ENable iPERFormlRESPonselSCHedulelUSER|M 

that occur in the real machine. ' llNSTsimjDAStapiSEEKsiSYSprof ( 

128 
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MONITOR (cont.) 

Note; Modifications to DMKMCC 
are necessary to use the Response 
option. 


INTerval nnnnn [SECIMINI[mm3 

STArt SPOOL [to userid! [BUFFS nnl 

TAPE raddr [mODE ( 800/1[BUFFS n] 

hsoo n 

/6250 ij 

CPTRACE 

STOP ISPOOLITAPEICPTRACE] 

CLOSE 

AUTOdisk [ON|OFF) 

TIME rFROM hl:ml TO h2:m2) 

)FOR hh:mm V 

Ull ( 

(none ; 

LIMIT n [NOSTOP 1 STOP 1 SAMPLE] 

SEEKS (INclude raddr raddr...) 

)Exclude raddr raddr...V 

)DELete ( 

(Display ; J 


^Select one or more of the classes^ subject to the restrictions listed Mith the ENABLE operand. 
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Description 


glOVEFIJLE CMS 

Moves data from one device to 
another device. 

MSG RSCS 

Allows message text to be sent 
via RSCS remote or local stations 
to any RSCS facility or VM/370 
user. 


MSGNOH CP Class B 

Allows a virtual machine to send 
messages without the standard 
header associated with the 
MESSAGE command. 


NAMEFIND CMS 

Display/stack information from a 
NAMES file, (default *userid 
NAMES’). 


NAMES CMS 

Display a menu to create»display 
or modify entries in a ’userid 
NAMES’ file. (The menu is avail~ 
able only on display terminals.) 


Format 


MOVEfile 


inddname 
I NM OVE 


outddname 

OUTMOVE 


1 ! 


C(PDSC))3 


Msg 1inkid [userid] msgtext 


MSGNOH juserid| msgtext 


TALL 


NAMEFind :tag value [:tag [value]]... [options...[)]] 


STACK 

[n| 


1 

] [FIFOILIFQ] 1 

1 [File fn 

] 

FIFO 

[n 1 


i 

] 

1 [LINenum 

] 

LIFO 

[n| 

\*\ 

1 

] 

i [STARt recnum 

] 

TYPE 

[n 1 


i 

3 

1 [SlzelnjJtl i 

]] 


NAMES [nickname] 
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NCPDUWP CMS 

Processes CP spool reader files 
created by 3705 dumping 
operations. 

NETMORK CP Class A 

Stops communications to 370x 
controllers or resources or 3270 
remote equipment. 

NETMORK CP Class A and B 

Controls the 370x control 
program and its resources. Also 
provides a means of altering 
binary synchronous line poll 
delay interval. 


NOTE 

CMS 

INOTE r 

Prepare a ’note* for one 

or more 

! ! 

computer usersf to be ser 

it via 

I L 

the SENDFILE command. 


1 r 



1 1 

1 L 


NCPDUMP CDUMPxx] 

[([ERASE] [NOFORM] [MNEMONIC][NCPBUFF][)]] 
NETWORK SHUTDOWN [raddriALL] 


NETWORK LOAD raddr ncpname 

DUMP raddr [ IMMED I OFF I AUTO] 

ENable [ ALL Lresidiresid...]] 

DISAble [ALLLresidLresid...]] 

Query[ACTiveIOFFline|FREet ALLiresid[resid. 

POLLdlay nnnn [ALLiraddr] 

VARY CONIineIOFFline[resid...] 

ATTach resid [TO] userid [AS] cuu 


iDETach resid [FROM] userid 


|nickname2 I 

juseridZ [AT node]!... 


fuseridl [AT node]? j^useridZ [AT node]J . 
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1 Description 

Format 

NOTE (cont.) 

C(options...[)]] 


options: 

CACkl NOAckl 

CADdl 
[Cancel1 

CNOTebook fniNOTebook X|NONotebook] 

CLOGiNOLog] 

CLONolShortl 

[Replace] 

[PROFile fn] 

INOTREADY CP Class G 

I Simulates loss of ready status on 

1 virtual device. 

1 

NOTReady vaddr 

INUCXDROP CMS 

1 Deletes specified nucleus 
extensions. 

NUCXDROP jnamel [name2...]| 

INUCXLOAD CMS 

1 Loads a nucleus extension 

NUCXLOAD iname [fn] } 

]name member ddname ) 

[([SYstemi [SErvice] [Push] [)]] 

INUCXMAP CMS 

i Identifies existing nucleus 
j extensions. 

NUCXMAP [ALL] [([STACK] [lIFo] [)]] 
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OPTION CMS 

In CMS/D0S» changes any or all of 
options in effect for the DOS/VS 
COBOL compiler. Only specified 
options are changed. 


l ORDER CP Cl ass D 

1 Places closed spool files in a 
I specified order by device type. 

I (A combination of CLASS and 
spoolid specifications may be 
I entered.) 

I ORDER CP Class G 

I Places closed spool files in a 
I specified order by device type. 

I ORDER RSCS 

I Reorders file queue for a link. 


OPTION 



[options. 


.] 


DUMP [deck 1 [list IFlISTX 1 fsYM ] 

NODUMP ^ ^NODECKJ ^NOLISTj ^NOLISTX ^ ^ NOSYM J 

XREF 1[ errs 1FaBcI[tERM 1 
NOXREF ^ ^NOERRS^ UOC ^ I ^NOTERM J 

ORDer userid (READER HCLass cl Class c2... 

SYSTEM <Pri nter> •< spool i dl spoolidZ... 

x /punch \(F0Rn forml FORM formZ ... 


ORDer (Reader /(CLass cl CLass c2... 

^Printer UfORM forml FORM formZ... 
/PUnch \/spoolidl spoolidZ... 

ORDer [linkid] (spoolidl [spoolidZ ...]} 


i l OSRUN CMS 

I Executes a load module from a CMS 
I LOADLIB or an OS module library. 
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Description 

PUNCH CMS 

Directs a specified spool file to 
the virtual punch. 


PURGE CP Class D 

Deletes a closed spool file 
before reading, printing, or 
punching occurs. (A combination 
of CLASS and spoolid speci¬ 
fications may be entered.) 

PURGE CP Class G 

Deletes a closed file before 
reading, printing, or punching 
occurs. (A combination of CLASS 
and spoolid specifications may be 
entered.) 

PURGE RSCS 

Removes inactive file queued on a 
specified link before it has been 
selected for processing. 

QUERY CP Classes A,B,C,D,E,F,G 

Displays system software mainten¬ 
ance information, log messages, 
the number of logged-on-users; 
lists logged-on users. 


PUnch fn ft [fm|)«] C (opt i ons. . . C ) J ] 
options : 

HEADER 1 [member Jmembernamen 
NOHEADER I I H 


userid iReader { AL L 

SYSTEM yPrinter ICLass cl CLass c2 ... 

\PUnch jspoolidl spoolid2 ... 

-• / I FORM forml FORM form2 


Reader CLass cl CLass c2 ... f 
Printer j FORM forml FORM form2 ... I 
PUnch ( spoolidl spoolid2 ... ( 
ALL I ALL \ 


PURge Clinkidl \ALL f 

ispoolidl Cspoolid2...]i 


Query (CPLEVEL 
j LOGmsg 
\Names 

/Users [userid] 
\userid 
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QUERY CP Class A iQuery 5S370E ( 

Displays system status, paging, (SPMODE) 

scheduling, and machine config— j 
uration information. j 


?UERY CP Classes A,E iQuery 

Provides the paging activity j 

index or specified user priority | 
or status of the Virtual Machine I 
Assist feature. j 


PAGing 

PRIORity userid 
SASsist* 

CPAssist* 

AFFinity Cuseridl 

QDROP 

journal* 

ATTach resid [To] userid [As] cuu 
DETach resid [From] userid 
SRM /APAGes 

DSPSlice 
MAXUss 
MAXDrum 
. PCI 

PB : 

IB 

PGMStat 

PGMTlim 

Ihhfull 


^Combined use of QUERY CPASSIST and QUERY BASSIST determines the current status of the expanded 
virtual machine assist portion of VM/SP Extended Control Program Support (ECPS). 

*The JOURNAL operand is valid only if STQUERY=YES is specified in the SYSJRL macro instruction in 
DMKSY5. 
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Description 


QUERY CP Class B Query 

Provides the current status of 
all system devices. 


Format 


DAsd ISysvirtI 

ACTive 


Virtual 

OFFline 

[PATHS] 

TApes ^ -» 

FREe 


LINES* 

ATTach 


UR 

ALL 


GRaf 



VALL 



DAsd volid 

TDsk 

STORage 

raddrl C-raddr2] 
SYStem raddr 
DUMP 
k Lnnn 


QUERY CP Class D 

Provides data on spooling 
operations. 


Queryj 


Files [Class c] [FORM form] Cuserid|x] 


NOHold * 
HOld 

USERhold 

SYShold 


Reader 

punch 

Printer 


HOLD 


H[Class c][FORn form] 

\spoolid 


[ userid 
* . 


NOHold 

NOld 

SYShold 

USERhold 


[ALL] 

[TBL] 


V, 
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Provides system status and 
machine configuration 
information. 


CP Class G I Query 


Time 

Set 

Terminal 

Files [Class cl [FORM form] NOHold | 

HOld I 
USERholdl 
SYShold I 



CHANnels 



GRAF 



CONsole 



DAsd 



TApes 



LINES 


[Virtual] 

UR 



STORage 



ALL 



vaddr[-vaddr] 



*■ 



I I Links vaddr 
I CPUid 

I 1 SECuser 

'Query LINES is not effective for 3704/3705 resources unless the 3704/3705 is operating in 270x 
Emulation Program (EP) mode. VM/SP does not support the Netuork Control Program (NCP) mode nor 
the MTA (Multiple Terminal Access) feature of NCP. However, if the VTAM Service Machine (VSM). 
component of SNA (Systems Network Architecture) is in place, the appropriate network control 
program will be in effect. VM/SP also does not support the Partitioned Emulation Program 
(PEP) mode. 

^These operands may be in any sequence. 
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QUERY (cont.) 


RDYMSG ^ 

LOADLIB 

TXTLIB 

CMSLEVEL 

REDTYPE 

RELPAGE , 

SEARCH 

SYNONYM {SYSTEMlUSERlALDl 
SYSNAMES 


CMS/DOS Functions ; 
^DLBL 
DOS 

DOSLIB 
- DOSLNCNT 
DOSPART 
OPTION 
VUPSI 


QUERY 

Indicates the name of the Prog¬ 
rammable Operator's active 
routing table. 


QUERY RTABLE 


QUERY RSCS |Query 

Queries RSCS linkid^ file or 
system status information. | 

QVM CP Class A jQVM userid CNORETURN] 

Requests the transition from | 

VM/370 to a particular virtual | 

machine^ running in native mode. | 


(linkid C Stat IDefI Queue] 
<File spoolid [ Stat IRSCSIVMl 
(SYstem [Active] 





142 IBM VM/SP Quick Guide for Users 


Description 

RPR CMS 

Generate a return code and either 
display or stack a message that 
identifies the characteristics 
of the next file in your virtual 
reader. 


RPRLIST CMS 

Display information about files 
in your virtual reader with the 
ability to isssue commands from 
list. 


R E AD- CA RP CMS 

Reads data from the virtual card 
reader^ and creates CMS disk 
files containing the data. 


READY CP Class G 

Makes a device end interruption 
pending for the specified device. 




Format 
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RgCIIVE CMS 

Read onto disk a file or note 
1 that is in your virtual reader 


RELEASE CMS 

Makes a disk and its directory 
inaccessible to a virtual 
machine. 

RENAME CMS 

Changes the name of one or more 
CMS disk files. 


{RECEIVE [spoolidICfn [ft [fmll C(options...I)313 
g ption^ ; 

[NOTebook fniNOTebook *3 
C log I NOLogI 
I [Purge! 

( [Replace! 

I [ Qlddate l NEudate! 

1 [Slack! 

iRELease Ccuulmode! [(DET [)33 


{Rename fileidl fileid2 [(options...[)33 
pptions ; 

L [type Fnoupdirt 

I [NOIYPEj [updirt 


REPEAT CP Class D 

Holds or increases the copies of 
an output spool file. 

REQUEST CP Class G 

Makes an attention interruption 
pending. 

RESET CP Class G 

Clears all pending interruptions; 
resets error conditions on the 
device specified. 


iREPeat raddr Unn|13 { 
I Unn3H0LDt 


{RESET vaddr 
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Description 

REMIND CP Class 6 

Reuinds a real tape drive. 

RO CMS Immediate Command 

Resumes recording of trace 
information previously suspended 
by the SO Immediate command. 

RSERV CMS 

In CMS/D0S» copies^ displays^ 
prints» .or punches a DOS/VS 
relocatable module from a private 
or system library. 

RT CMS Immediate Command 

Resumes terminal displaying. 

RUN CMS 

Initiates a series of functions 
for a file depending on the 
file type. Selects or combines 
the procedures to compile^ load/ 
or start execution of the 
specified file. 

SAVENCP CMS 

Reads/Loads 3705 control program 
load module. 

Note: CP command privilege class 
A/ B/ or C is required to use 
SAVENCP. 
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SAVESYS CP Class E 

Creates a copy of virtual machine 
storage, registers, and PSW. 

SCREEN CP Class G 

Alters or changes any color 
and/or extended highlighting for 
the virtual machine display area, 
as well as the color in the input 
area and the status area. 

SEND CP Class G 

Passes commands and message 
replies to the designated 
disconnected virtual machines for 
execution. 

SENDFILE CMS 

Send files or notes to one or 
more computer users, attached 
locally or remotely, by issuing 
the command or by using a menu 
(display terminal only). 


i SENTRIES CMS 

I Determines the number of lines 
I currently in the program stack. 


SAVESYS systemname 


F lextcolor 
I < DEFault 


exthi1ightf 
NONe > 


SEND CCP] userid [text] 


SENDFile Cfn ftCfm][CTO]inicknamel 


?useridl[AT node]Muserid2[AT node]j 


Coptions...[)]]] 

options ; 

[AckI NOAck ] 

C FileiistI NOFileiist ] 

C log 1NOLog] 

C NEw iOld] 

[NOTE] 

C Tvpe lNOTvpe] 


^Each time you enter the command, you must specify at least one screen ’area* operand with at 
least one ’extcolor' and/or ’exthilight’ value. You may specify more than one ’area’ operand on 
the same command line. 
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I 

I 

I 


Description 


SET CP Class A 

Sets special CP preferred 
options. 


SET 


SET CP Class B 

Establishes disposition for log 
messages and dumps. 


SET 


Format 


AFFinity Cuseridl [0N|0FF|nn3 
CPAssist CONlOFF) CPROCCnnJ] 
FAVORed userid [xxxCxxlIOFFl 
REServe userid (xxlOFF) 
SASsist (ONlOFF) tPROCCnnll 
PRIORity userid nn 
journal^ iLOgon< [fiN|OFF 3 
jLInk S 

S370E {ONlOFF} [CPROC3addr3 
^ QDROP userid CON|OFF}[USERS3 

LOGmsg {nn|NULL3 I 

DUMP {AUTOlraddr} [ALLl£P3\ 


SET CP Class E 

Sets SRM function and the number 
to be used in the Morking set 
size estimate control algorithm. 


SET 

' SRM 

' MAXWss {nnnnIOFF} ' 
MAXDrum (nnnnjOFF} 




PCI {DRUMIDISK} 

PB nn 

IB n 

PGMTlim 

MHFULL (nnnlOFF} 
APA6ES nnnn 

DSPSlice nn.n , 



S PAGing nn 
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SET CP Class F 

Sets recording mode for a device, 
or enables/disables soft machine 
rheck interrupts. 


SET RECordfOFF 

Jon raddr LIMIT nn BYTE nn BIT n 



BYTE nn BIT n 


MODE JRETRY? ^Quiet / Ccpuidl 
IMAIN { JRecordi 


MI CP Class G 

The SET command controls various 
functions within your virtual 
machine. 


ACNT 

AUTOPoll I 

RUN I Ion 

LINEDit UOFF 
NOTRans 
ECmode 
ISAM 

Vpagex 

EMSG {ONlOFFlCODElTEXTlIUCV} 
TIMER {ONIOFFIREAL} 

CPUid bbbbbb 
IMSG ( ON 
■ -^OFF 


MSG . 

SMsg /lUCV 


cpcoNio s off / 
lVMCONIO jlUCVi 


*The JOURNAL operand is valid only if STQUERY=YES is specified in the SYSJRL macro instruction 
DMKSYS. 
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Description 

Format 

SET (cont.) 

1 

1 

1 

fAssist UONlCSVClNOSVCJCTMRlNOTMRli 
jOFF \ 

AFFinity [0N|0FF] 

PFnn [IMMed ] Cpfclatal#pfdata2#. , .pfdatanl 
CDELaved] 

PFnn [TAB nl n2...nnl 

ICresid] / 

PFnn [COPY Ucuu] h 

([luname]) 

PFnn RETrieve 

VMSAVEi {ONlOFFIname} 

STBypass (hnnnnnKj [nOVERIFyH) 
llnnM h 

.VOFF ' 

STMulti iFn [[uSEG xxIcSEG yyylll 

r LL j jj 

( OFF ) 

.370E CONIOFF] 
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Control various functions within 
your virtual machine. (Only one 
function may be specified per SET 
command. 


CMS I SET function 


function r t 

functions : ELDRTBLS nn] [OUTPUT xx a] I RDYMSG I LMSG I 

UDYMSG SMSGJ 

[INPUTCa xxlxx vv)3[ RELPAGE {OFF I ON)3[ ABBREV (OFF I ONI 1 
BLIPlstring C(count)3/l [ PROTECT (OFFlON}3 [CMSTYPECHT|RT)3 

. I 

[iMPEx off] [impcp off! [ redtype off I Tautoread on 
Umpex on J [impcp M J ^redtype on j [autoread off 


SYSNAME VCMSVSAM/ entrynamel |NONSHARE ICMSVSAM 


[cMSTYPE 


CMS/DOS functionSt 


[dOS on [mode[(VSAM[)333 
I DOS OFF 

L 

[DOSLNCNT nn3 


UPSI nnnnnnnn 
jUPSI OFF 


IIDOSPART nnnnnK 
IIDOSPART OFF 


^When specifying this oper 


virtual machine size cannot exceed eight megabytes. 
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Sends a ’special message* to a 
virtual machine which is running 
with SET SMSG ON. 


SO CMS Immediate Command 

Suspends the recording of trace 
information during the execution 
command or program. 


SO 


SORT CMS 

Sorts records within a file and 
creates a new file containing the 
sorted records. 

SPACE CP Class D 

Forces single spacing on the 
printer. 


SORT fileidl fileid2 


SPAce raddr 


ISPMODE CP Class A 

I Establishes or resets the 
single processor mode. 


SPOO L CP Class G 

Changes spooling control options 


SPMode iON ( 
/OFFt 


SPool \Reader[ 
)vaddr \ 



^At least one of the options within braces must be selected; however# more than one may be 
specified# and they may be entered in any order on the command line. 
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[ To 1 (userid } [HOld 1 [( 

OFF [Class cH( 


[Class cHC0py[x]nnn3 
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SPTAPE CP Class D 

Dumps output spool files to tape 
or loads output spool files from 
tape. 


SPTape 


STOP raddr 


CANCEL raddr 


SCAN raddr 


le a v e 1 

REUindl 
RUN I 

j 


LOAD raddr (Printer/ 

spoolidl[spoolidzl 


LEAVE 

<PUnch > 

lEND 1 


REWind 

/Reader ) ^ 

L J 


RUN 


CLass cl CLass c2... 




FORM form 

1 


(ALL 



CCSYSHOL D]t USERHOLD][nohold]] 


DUMP raddriPrinter/ 

spoolidl1 

spool idzl 1 


M0DE( 800/ 

^PUnch \ 


end 1 


n600> 

/Reader 


L J ' 


6250 ) 


ICLass cl 

CLass c2.. 1 




FORM form 



(ALL 


1 


^At least one of the options within braces must be selected; however, more than one may be 
specified, and they may be entered in any order on the command line. 

^These options apply only to a virtual spooled console. 

^These options can only be used to modify a virtual spooling printer. 

These options only apply to a D/T 3800 as a virtual spooling device. 
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I 


Description 


Format 


SPTAPE (cont.) 


LEAVE 

REWind 

RUN 


CSYSHOLD3CUSERHOLD3[NOHOLD]][PURGE] 


SSERV CMS 

In CMS/D0S» copieSf displays^ 
prints, or punches a book from a 
DOS/VS source statement library. 


SSERV sublib bookname [fti COPY ] [(options...[)33 
opt ions : 

[ DISK ] [PRINT] [PUNCH] [TERM] 


START CP Class D 

Restarts a drained device or 
changes its output spooling 
class. 


STArt 


Reader 
Pr 1 nter 
PUnch 
ALL 


raddriCLass c. 


] 

FORM form! [NOsep] 

Auto 1 

1 

r 1 1 

N03800 1i 

1 

FORM X 1 

SETUP 1 

BEG380011 


L J 

MAnualj 

ANY380011 



L J 

'' -* 1 


FLash name 
CHars name 
FCB name 
IMage namedsys 
PUrge 
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START 

Begins program execution. 

CMS 

START 

entry 

K 


args... 



L 

(option! )] 

j 


START 


Activates an RSCS link that is 
in the deactive state to start 
processing files. 


STAT IPC5 

Provides current status of a 
problertif a specific subset of 
problems, or all problems. 


STATE/STATEUi 


_ CMS 

STATE verifies the existence of i 
file on any accessed disk. 

STATEU verifies the existence of 
a file on a read/write disk. 


option : 
NO 


STArt Clinkidl 


STAT \ nnnnn 
i ALL 


CLass c 
LINE vaddr 
TASK name 
TYPE driverid 


Status Keywords; 

OPENUSER 
OPENIBM 
OPEN 
APARED 
NEEDINFOl 
PTFRCVD 
PTFON 
CLOSED 


[Parm...3 




Failure Keywords: 

ABEND 1 

(DOClDD) 

INcorr 
INF 

{LOOPILP} 

MSg 

(PERFORMIPR) 
(WAITIWS) 
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Description 

STCP CP Class C 

Alters contents of real storage. 
The real PSW or registers 
cannot be altered. Shared pages 
in a system running in AP mode 
cannot be altered. 


STOP 

Stops operation of the Program¬ 
mable Operator. 

STORE CP Class G 

Alters virtual machine storage^ 
PSW, and registers. 


hexloc 1 
Mhexloc I 

Nhexloc I hexwordl hexNord2. 
Lhexloc I 
MLhexloc I 
NLhexloc/ 

Shexloc ) 

f1Shexloc> hexdata 
NShexloc \ 


Jhexloc (hexwordlChexword2...1 
Hhexloc) 


Shexloc hexdata 


jGregJ hexMordl[hexMord2...3 
IXregj 


{Yreg} hexduiordl [hexdMord2. . . 3 
PsN ChexMordl3 hexword2 
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SVCTRACE CMS 

Records information about 
supervisor call instructions. 

SYNONYM CMS 

Specifies alternate names for 
invoking CMS commands. 


SYSTEM CP Class G 

Simulates virtual machine con.sole 
functions and clears virtual 
storage and storage keys to 
binary zeros. 

TAG CP Class G 

Appends or queries the TAG text 
to a VM/SP spool file utilized 
by subsystems (such as 
RSCS) . 


SVCTrace iON I 
loFF^ 

SYNonym fn fm [(options...!)]] 

SYNONYM Ai 

opt ions : 

[NOSTDISTD] [CLEAR] 


SYStem (CLEAR 
•^RESET 

/restart 


TAg DEv (Printer) [tagtext] 
;PUnch \ 

(CONsolej 
(vaddr ) 


File spoolid [tagtext] 


(Printer 

)PUnch 

DEv )CONSole 
(vaddr 

File spoolid 
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Description 


TAPE CMS 

Performs tape to disk or disk to 
tape operations for CMS 
files. 


TAPE 


DUMP 

LOAD 


Format 






[(optionA optionB optionDC)]] 

CCoptionB optionC optionDC)]] 



[(optionB optionC optionDC)]] 


CCoptionB optionC optionDC)]] 


DVOLl [(optionD optionEC)]] 

UVOLl volid Couiner] [(optionD optionEC)]] 

MODESET C(optionDC)]] 
tapcmd Cnii] [(optionDC)]] 

Note : The tapcmd operand can be one of the folloMing: 

CBSF|BSR|ERG|FSF|FSRIREWIRUNIWTM] 
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ITAPE (cont.) 


1 rflAPn 

cuu 

1 TAPI 

181 

|LL 

L JJ 


TAPEWAC CMS 

Creates a CMS MACLIB from an 
unloaded partitioned data set 
(PDS) from a tape created by the 
lEHMOVE utility program under OS. 


optionA ; optionB ; 

WTM 1 IBLKSI2EJ4096 M UoPRint 

NOMTM } 800i PRint 

DISK 
T erm 


opt 1 onC : 

EOF n 
EOT 
EOF 1 


CTRTCH {OlOClOTlElET}] |7TRACK1 
I9TRACKI 


[DEN {200|556|800il600|6250}] 


optionE ; 

LEAVE 1 

REUIINDl 


TAPEMAC fn |SL Clabeldefid] I 

INSL filename [ID=identifier]I 


ITEMCT yyyyyl 


[fAPn 

■ 

ITAPI 

L J 



[(options...[)]] 
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Description 


TAPPDS CMS 

Creates CMS disk files from tapes 
which are input to or output from 
the lEBPTPCH, lEBUPDTE, and 
lEHMOVE OS utility programs. 


TELL CMS 

Send a message to one or more 
i computer users who are logged on 
to your computer or to one 
j attached to yours via RSCS. 

I TERMINAL CP Class G 

Controls virtual console 
I functions. 


TAPPDS Ifn [ft rtmlll FsL Clabeldefidl 

a a j^NSL filename C ID= i dent i f i er ] 

[ Copti ons. . . [ ) ] ] 

options ; 

update! FcOLI ! fTAPnl [eND 1 [mAXTEN 

NOPDS INOCOLII I TAPI I NOENDl NOMAXTEN 
PDS J 

TELL ^nickname ^ message 

luserid CAT node]) 


tCHardel ) 
UlNEDel f (ON 
(LINENd > |0Ff 
I EScape V / char 
[ TABchar^' 

fAPL ) 

VTEXT f (ON / 
(ATtn > }0Ff( 

/Hllight V 
SCRNsave) 
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0m^ 


TERMINAL (cont.) 


MODE (CPlVM) 
LINESize {nnnlOFF) 


TRACE CP Class G 

Traces and records program 
execution. 


CONmode {3215|3270} 

BREakin (IMmed|GUESTct1} 
BRKkey {PAl|PFl|...1PF24) 
TYpe {3101ITTY} 

PROMpt {VMITTY} 

SCROLL {nnnICONT} 

PRINTer ') 

TERMinal l> i NORun I 



RUN I 


^More than one function can be specified in a single entry of the TERMINAL command. For example: 

TERMINAL CHARDEL OFF MASK ON LINESIZE 90 
^The TABCHAR operand is available on the 3278 Model 2A console. 

^More than one of these activities may be traced by using a single TRACE. For example: 

TRACE SVC PROGRAM SIO PRINTER 
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Description 

TRACE RSCS 

Traces and records certain line 
and error activity for a 
specified link. Available to 
RSCS operator only. 

TRANSFER CP Class D 

Transfers closed reader spool 
files. 


TRANSFER CP Class G 

Transfers closed reader spool 
files. 

TRAPPED CMS 

A reduction program that will 
display to a terminal or print 
a CPTRAP READER file. 

TXTLIB CMS 

Updates a library of TEXT files 
(object modules). 


TYPE CMS 

Types or displays all or part of 
a file at a terminal. 


TRace linkid [ALL IERRorsIEND3 


TRANsfer userid PRinter 
SYSTEM punch 
a Reader 


spool i d 
CLass c 
FORM form 
ALL 


TRANsfer Printer 
punch 
Reader 

TRAPPED filenum 


spoolid 
CLass c 
FORM form 
ALL 


^ {) Printer 

useridw PUnch 
) Reader 

ALL 

useri d\) 

Printer 
> punch 
Reader 


TXTlib (GEN 1ibname fnl [fn2...] 

/ADD libname fnl Cfn2...3 
)DEL libname membernamel [membername2. 
(.MAP libname [ (opt i ons. . . C) 3 3 
options (for MAP only): LTERMl CPRINT3 C DISK 3 

Type fn ft fmj recllrecn C(options.. . C)33 

.xj I \*- 
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TYPE (cont. ) 


UNLOCK CP Class A 

Releases pages of storage. 


UPDATE CMS 

Makes changes in a program source 
file as defined by control state¬ 
ments in a record file. 


options : 


COL |xxxxx| - 


yyyyy 

1 reel 


[HEX] IMEMBERU i 
1 ]name> 

UNLOCK j(useridI SYSTEM) firstpage lastpage 

) {VIRT = REALIV = R} ) 

Update fnl 


opt ions; 


ftl 

ASSEMBLE 


fml [fn2 [ft2 [fm2]]] 
A1 


[(options...[)]] 


REP 

SEQ8 1 

INC 

NOCTL 

STK 1 

NOREP 

N0SEQ81 

L J 

NOINC 

L J 

CTL 

NOSTKl 

L J L 


TERM 

NOTERM 


jPRINT 

I DISK 


Control Statements : 

./ S Cseqstrt Cseqincr [label]]] 

./ I seqno [$ [seqstrt [seqincr]]] . 

./ D seqnol [seqno2] [$] 

./ R seqnol [5eqno2] [$ [seqstrt [seqincr]]] 
./ [comment] 


VARY CP Class B 

Varies the availability of a 
device. 


VARY 


J ONLine J (raddr... / 

(OFflineJ ^raddr-raddr f 
/PROCessor ) 

OFFline PROCessor nn [options] [FORCE] 
opt ions : 

[vPHY 
I VLOG 

L J 
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Description 

Format j 

VMDUMP CP Class G 

VMDUMP 

hexlocl 


[hexloczl 


TO K 

[FORMAT vmtype] 

Dumps storage for virtual 


0 


lEND 

1 


TO userid 


machine. It enables sending 




L 

j 


SYSTEM 


dumps to other users. Used in 




r T 




conjunction with the VM/IPCS 



{.} Ibytecountj 

CDSS] [Xdumpid] 

Extension. 



L 

1 END 

L 

1 

J J 


VMFDUMP IPCS.Service Aid 

VMFDUMP 

[PRBnnnnn] 

ERASE 



Formats and prints, or erases. 




NOMAP 



an existing dump. 




NOHEX 







NOFORM 







NOVIRT 



UARNING CP Classes A,B 

iWarningf (userid 

1 

msgtext 


Sends high priority messages. 

/WNG 

\ -{OPeratorf 






(ALL 





XEDIT CMS 

XEDIT Cfn [ft Cfm]]] 

C options...[)]] 

Creates, modifies, and manipu¬ 







lates CMS disk files. This is 

opt ions: 





the VM/SP System Product editor. 

[Width nn] [NOSCreenl [PROFile macroname] CNOCLear] I 

Once XEDIT is invoked you may 




CNOPROFi 1 

] 

execute XEDIT subcommands and 







use the EXEC 2 macro facility. 








% 
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XEDIT (cont.) 

1 Note; In all formats of the 

1 XEDIT subcommands and macros^ 
use of the word "subcommand" 

1 means an XEDIT subcommand only. 

options valid only in Update mode: 

Update 1 Seq8 ] [ctl fnl] [Merge] 

NOUpdatel N0Seq8| iNOCtl | 

J L J L J 


Cincr nn] CSIDcode string] 

1 

The XEDIT subcommands and macros are: 

Redisplays the subcommand and 

1 allows reexecution by pressing 

1 the ENTER key. 

4 [subcommand] 

i Displays the last executed 

1 XEDIT subcommand except for the 

1 = (equal sign) or the ? 

I (question mark) subcommands. 

7 

1 

1 Reexecutes the last subcommand 

1 or macro that was entered. 

1 Also executes a specified sub- 

1 command and then reexecutes the 

1 last one entered. 

= [subcommand] 

Inserts blank lines immediately 

I following the current line. 

Add [n|i] 
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i Description 

Format 

ixEDIT (cont.) 

1 Changes a single character to 

j another character unavailable 

j on terminal keyboard by 

1 referencing their hexadecimal 

1 values. This is a macro. 

r 

Alter charl char2 target 

1 

[n [pin 

llll 

1 •- -«! 

G M 

L J 

1 Scrolls backward the number of 

1 screen displays specified. 

BAckward [n|)<!l.3 


j Makes the last line of the file 
j or of the range (see SET RANGE) 

1 the new current line. 

Bottom 


1 Terminates the editing session 
j for all of the files. This is 
j a macro. 

CANCEL 


j Appends specified text to the 

j end of the current line. This 

j is a macro. 

CAppend Ctext] 


j Deletes one or more characters 

1 from the current line, starting 

j at the column pointer. 

CDelete [column-target|1] 


1 Moves the column pointer to the 

1 beginning of the zone (see SET 

1 ZONE). 

i- 

CFirst 




\ 
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XEDIT (cont.) 

Changes a specified group of 
characters on one or more lines 
at one time. 

Inserts text into the current 
line immediately ahead of the 
column pointer. 

Moves the column pointer to the 
end of the zone ( see SET ZONE). 

Scans the file for a specified 
column-target starting at the 
column following (or preceding) 
the column pointer in the 
curent line. Also finds 
successively all occurences of 
a character string, 
string. 

Forces the editor to transmit a 
command to CMS for execution or 
causes the editor to enter CMS 
subset mode. 

Displays a message in the 
command line; intended for 
issuance from a macro. 




CLAst 

CLocate column-target 


CMS Ccommandline] 


CMSG [text] 
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Description I 

Format 

1 

XEDIT (cont.) 1 

Causes the editor to execute a j 
specified XEDIT command without! 
first checking for a synonym orj 
macro with the same name. j 

COMMAND Ccommandlinel 

Prepares one or more lines for | 
automatic repositioning of dataj 
(see SET TABS). I 

1 

COMPress [targetll^] 

1 

Copies one or more lines at a | 
specified location in the file.j 

1 

copy targetl targetZ 

1 

Displays the number of times a | 
specified character string j 

appears in one or more lines» j 

beginning at the current line. | 

1 

count /string C/targetlil 

Selectively replaces one or I 
more characters in the current j 
line with the same number of j 
characters keyed in. I 

COVerlay text 

Transmits commands to the VM/SP1 
control program environment I 
during an editing session. 1 

CP [commandline] 

Replaces one or more characters! 
in the current line. I 

CReplace text 


t 
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XEDIT (cont.) 

Moves the cursor to a specified 
posi t-i on. 

CURsor CMdline [colnoll.1 

Column 

File lineno [colnol 

Screen lineno Icolnol 

Deletes one or more lines from 
a file beginning with the 
•current line- 

DELete Ctargetlil 

Moves the line pointer down a 
specified number of.lines 
toward the end of the file. 

Down [n|M|Jj^l 

Duplicates one or more lines 
beginning with the current 
line. 

DUPlicat Cnllltargetim 

Displays a message at the term¬ 
inal or used in macros and 
modules that interface with 
XEDIT and whose messages follow 
VM/SP message rules. The sev¬ 
erity determines whether or not 
the alarm sounds. 

EMS6 (text ( 

/ Cmmmnnna textli 
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Description 


XEDIT (cont.) 

Repositions data in one or more 
lines that contain tab 
characters (X»05»). 

Writes the edited file onto 
disk and optionally overrides 
the originally supplied file 
i identifier. 


Searches forward, starting with 
the current line, for the 
operand-specified text. 

Searches backward, starting 
with the current line for the 
operand-specified text. 

Scrolls toward the end of the 
file the operand-specified 
number of screen displays. 

Inserts all or part of a 
specified CMS file following 
the current line of the edit 
f i le. 


Format 


EXPand [targetill 
FILE fn ^ft 

Find text 

FINOUp text 
FUp 

Forward Cnixtll 

GET Cfn| = Cft|=CfmI = |klEfirstrec|JLCnumreclil3333 
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XEDIT (cont.) 

Displays a list of all XEDIT 
subcommands and macros and 
their descriptions> formatSf 
and parameters^ or invokes the 

CMS HELP command. 

Help 

CMENUl help 1 name] 

Displays a specified number of 
lines in both hexadecimal and 
EBCDIC. This is a macro. 

HEXType CtargetlJLl 

Inserts a single line into a 
file. Also used to leave edit 
mode for entry into input mode. 

Input 

[line] 


Merges two lines at the column 
pointer or at the cursor. This 
is a macro. Also merges two or 
more lines at a specified 
column number(s) or inserts a 
specified character string(s) 
before appending the next line. 

Joi n 

Column 

CURSOR 

colno 

/string/ 


Allows viewing of columns not 
currently visible on the screen 
that lie to the left of column 
one. 

LEft 

[nil] 
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Description 

Format 

XEDIT (cont.) 

Reads a copy of the file being 
edited into virtual storage. 
This subcommand can only be 
issued from the XEDIT profile. 
AlloMS the macro to prompt for 
edit options or assign default 
values to edit variables. 

Note; Options specified in the 
XEDIT command override those 
specified in the LOAD sub¬ 
command. 

LOAD [fn [ft Cfm]]] C(options...[)]] 

options; r -i 

[Width nnl [NOSCreen] jPROFile macroname [NOCLear] 
iNOPROFil 

L J 

options valid onlv in update mode; 

[Update!NOUpdate] [SegS1NOSegSl 
[CTl fnllNOCtl] [Merge] [Incr nn] 

[SIDcode string] 

Scans file for a specified 
targets which (when found) 
becomes the current line. 

[Locate] target [subcommand] 

Changes all uppercase letters 
to lowercase letters in one or 
more lines. 

LOWercas [target il.] 

Causes the specified operand to 
be executed as a macro. 

MACRO [macroline] 
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XEDIT (cont.) 

Displays a subcommand and its 
current operand values so that 
new values can be typed over 
the current ones and the sub¬ 
command immediately reentered. 
This is a macro. 


MODify keyuiord 


keyword op 

erands: 



APL 

FType 

PACK 

SYNonym 

ARBchar 

HEX 

PFn 

TABline 

Autosave 

IMage 

Point 

TABS 

CASE 

IMPcmscp 

PREf ix 

TERMinal 

CMDline 

lINENd 

RANge 

TEXT 

COLPtr 

IRecl 

RECFm 

TOFEOF 

column 

MACRO 

SCAle 

TRunc 

CURLine 

MASK 

SCReen 

VARblank 

Escape 

MSGMode 

SERial 

Verify 

Filler 

NONDisp 

SPAN 

VERShift 

FMode 

Nulls 

STAY 

URap 

FName 

NUMber 

STReam 

Zone 


Moves one or more lines# I MOve targetl target2 

beginning uith the current I 

line# to a specified place in | 
the file. I 


Displays a message in the 
message area of the screen. 


MSG [text] 


Advances the line pointer a 
specified number of lines 
toward the end of the file. 


Next Cn|x|i] 
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XEDIT (cont.) 





Saves the settings of various 

PREServe 




XEDIT variables until a 





subsequent RESTORE subcommand 

settings saved incli 

jde: 


is issued. 

ARBCHAR 

IMAGE 

PACK 

TABS 


AUTOSAVE 

LEFT 

PREFIX 

TOFEOF 


CASE 

LINEHD 

RECFM 

TRUNC 


ESCAPE 

LRECL 

RIGHT 

VERIFY 


FILLER 

MACRO 

SERIAL 

VARBLANK 


FMODE 

MASK 

SPAM 

UIRAP 


FNAME 

MSGMODE 

STAY 

ZONE 


FTYPE 

NULLS 

STREAM 



HEX 

NUMBER 

SYNONYM 


Removes a copy of a macro in 

PURge macroname 



virtual storage. 





Inserts one or more lines^ 

PUT [target 

[fn [ft 

[fmll]] 


starting at the current line» 

li 

!= = 



into the end of an existing 

L 

L L 

L JJJJ 


file or into a new file or into 





a temporary file created by the 





editor. 
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Description 

Format | 

XEDIT (cont.) 

r r 

r r T 

m 


Inserts one or more lines* 
starting with the current line* 
into the end of an existing 
file or into a new file or into 
a temporary file. This command 
deletes the specified lines 
from the original file. 

PUTD {target f 

n jft Ifm 

! 1 ] 


Displays the current setting 
of various editing options. 

Query Coptionl 





options (specify only one 

each time): 



• APL 

IMage 

PointlMl 

TABline 


ARBchar 

inPcmscp 

PREfix 

TABS 


Autosave 

lASTmsg 

RANge 

TARGet 


CASE 

lENgth 

RECFm 

TERMinal 


CMDline 

line 

RESERved 

TEXT 


COLPtr 

lINENd 

RING 

TOF 


column 

IRecl 

SCAle 

TOFEOF 


CTLcharCcharl 

IScreen 

SCReen 

TRunc 


CURLine 

MACRO 

SeqB 

UPDate 


CURSor 

MASK 

SERial 

VARblank 


EOF 

MSGMode 

SlDcode 

Verify 


Escape 

NBFile 

Size 

VERshift 


Filler 

NONDisp 

SPAN 

Width 


FMode 

NUMber 

STAY 

MRap 


FName 

NUMber 

STReam 

Zone 


FType 

PACK 

SYNonymC Minamel 

= 


HEX 

PFIn] 
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XEDIT (cont.) 

Terminates the editing session 
and leaves the previous copy 
intact. 

Places data from the terminal 
into the console stack (LIFO). 
This subcommand generally is 
issued from a macro. 

Replaces a specified number of 
lines removed by a DELETE or 
PUTD subcommand or a D (delete) 
prefix subcommand. 

Renumbers the line numbers of 
VSBASIC and/or FREEPORT files. 

Advances the line pointer and 
executes the last subcommand 
entered. 

Replaces the current line with 
a specified line or keyed in 
text or deletes the current 
line and enters input mode. 


QUIT 

Cn3 


READ 

Cmdline 

TAG 1 


All [NUMBER3 

NOTAG 


Nochange [NUnBER3 

L J 


RECover [n|x|i3 


RENum C start-number 110 Cincrement3] 
REPEat [target] 


Replace Ltext3 







178 IBM VM/SP Quick Guide for Users 


Description 

Format 

XEDIT (cont.) 

Removes all prefix subcommands 
Mhen the screen is in a 
"pending” or "incomplete" 
status. 

RESet 

Restores the settings of the 
XEDIT variables to the values 
in effect when last the 

PRESERVE subcommand was issued. 

RESTore 

Allows viewing of data in 
columns not currently visible 
on the screen. These columns 
are to the right of the right¬ 
most column on the screen. 

Right tnliJ 

Enters the file that is 
currently being edited onto 
disk without returning control 
to CMS. 

SAVE ffn [ft [fmllj 

L L L J J J 

Locates every occurrence of a 
string and changes the string 
only when specified to do so. 
This is a macro. 

SCHANGE [keynumberl 

Changes the settings of various 
editing options while editing 
is in progress. 

SET option 
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I 


I 

I 


XEDIT (cont.) 

ShoMS whether keys are 
available. 




(must specify 
APL ON I OFF 


one ): 


Defines an arbitrary 
character used in a target 
definition. Note that the 
initial setting is OFF $. 

Sets or resets the automatic 
save function of the editor. 
Note that the initial setting 
is OFF. 

Controls letters entered and 
specifies significance in 
target searches. 

Specifies the position of the 
command line on the screen. 


[SET] ARBchar ONiOFF [character] 


[SET] Autosave niOFFlmodel^] 


[SET] CASE UppercaselMixedlRespectI Ignore] 


[SET] CMDline OniTopiBottom 


Determines (on typewriter 
terminals) whether or not the 
column pointer (underscore) 
is displayed. 

Define control character. 


[SET] COLPtr ONjOFF 


[SET] CTLchar char Escape 
OFF 

ProtectIHiqhi Nohigh lInvisible] 
NoprotectCHiohl Nohigh iInvisible] 

OFF 
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Description | Format 


XEDIT (cont.) 

Defines the nth line of the 
screen as the current line. 

Note that» on initial 
setting^ the n is the middle 
line of the screen. 

CSETJ 

CURLine ON n 

Allows entry of subcommand 
(on typewriter terminals) 
when in input mode without 
leaving input mode. 

[SET] 

Escape ONiOFF [character] 

Defines a character to be 
used when expanding a line 
(see EXPAND subcommand). 

[SET] 

Filler [character] 

Changes the filemode of the 
edited file. 

[SET] 

FMode fm 

Changes the filename of the 
edited file. 

[SET] 

FName fn 

Changes the fil.etype of the 
edited file. 

[SET] 

FType ft 

Allows subcommand operands 
and targets to be specified 
in hexadecimal. Note that 
the initial setting is OFF. 

[SET] 

HEX ONI OFF 
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XEDIT (cont.) 

Determines how tab characters 
(X*05*) and backspace 
characters (X’lS*) are 
handled. 

[SET] 

IMage ON|OFFlCANON 

Determines whether or not 
non-XEDIT recognized sub¬ 
commands are transmitted 
implicitly to CMS and later 
to CP for execution. 

[SET] 

IMPcmscp ONI OFF 

Determines whether or not 
it (pound sign) or other 
character is used as the line 
end character. 

[SET] 

LINENd ONlOFF [character] 

Defines a new logical record 
length for writing file to 
di sk. 

[SET] 

LRecl n|x 

Controls sequence of editor’s 
search for subcommands and 
macros. Note that the 
initial setting is OFF. 

[SET] 

MACRO ONlOFF 

Changes contents of mask. 

Note that the initial setting 
is a blank line. 

[SET] 

MASK Define 

Immed [text] 

Modify 
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Description 

Format 

XEDIT (cont.) 




Controls message display. 

CSETl 

MSGMode ON [Short I Long] i 

Note that the initial setting 
is ON LONG. 



OFF 

Defines a character to use in 

CSET3 

1 

NONDisp [character] j 

place of a nondisplayable 
character. 



1 

Specifies whether trailing 

CSETD 

NULls ONIOFF i 

blanks in each line are 
written to the screen as 
blanks (X*40») or nulls 
(X»00'). Note that the 
initial setting is OFF. 



1 

1 

! 

Determines whether or not 

CSET] 

NUMber ON|OFF 1 

line numbers are displayed in 
prefix area. Note that the 
initial setting is OFF. 




Specifies whether or not 
packed file is entered on 
disk. 

tSET] 

PACK 

ONI OFF 

Defines or removes a meaning 

CSET3 

PFn 

string | 

for a specified program 



TABKEY 1 

function (PF) key. Note that 
TABKEY is the intitial set¬ 
ting of the PF4 key. 



COPYKEYJ 
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XEDIT (cont.) 

Defines or redefines the 
symbolic name for the current 
line. 

Controls display of the 
prefix area. Also defines a 
synonym for a prefix sub¬ 
command. 

Defines neu limits for line 
pointer movement. 

Defines the record format for 
the file. 

Reserves a specific line on 
the screen for displaying 
blank or specified informa¬ 
tion. which can be highlight¬ 
ed. 

Displays a scale line under 
the current line (the 
default) or on a specified 
line. 


[SET] Point .symbol COFFl 

[SET] PREfix ON C lef1 1Rioht11 OFF 
PREfix Synonym new old 


CSETl RANge targetl target2 


CSET3 RECFm FlVlFPlVP 


[SET] RESERved[±|-]n Highttext] 

Hohighttext] 
OFF 


[SET] SCALe ON[n]iOFF 
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Description Format 

XEDIT (cont.) 

Divides the screen into a [SET] SCReen n 

specified number of logical Size nl Cn2] ... 

screens to allow editing of 
multiple files. 

Controls file serialization. CSET3 SERial PNCincrnoi lO Cstartnol1033 

ALLCincrnoT ToOO tstartnol lOOO ]] 
stringCincrnoI IOC startnoTlOJJ 
OFF 

Specifies whether a target- [SETl SPAN ON CBlanklNoblankCnlMn 

search character string must OFF 

be included in one line or 

span a certain number of 

lines. Note that the initial 

setting is OFF Blank 2. 
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XEDIT (cont.) 

Specifics Mhether or not the 
line pointer moves Mhen 
target-search object is not 
found. Note that the initial 
setting is OFF. 

Specifies Mhether to search 
entire file or only the 
current line for a character 
string. Note that the 
initial setting is ON. 

Specifies Mhether or not to 
look for synonyms. Also 
assigns a synonym to any 
existing subcommand or macro 
and defines an abbreviation 
for it. Also rearranges 
sequence of operand of sub¬ 
command the sequence of Mhich 
is different than that of 
XEDIT subcommand operands. 

Displays a "T" in every tab 
column according to current 
tab settings. 



tSET] STAY ONlOFF 

[SET] STReam 0N|0FF 

[SET] SYNonym ON|OFF 

SYNonym ncMnameCnloldname 

SYNonym ncMnameCnCforml...formn]]oldname[&l...tn] 


[SET] TABLine ONCn] 
OFF 
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Description 


XEDIT (cont.) 

Defines the logical tab stops 
for a file. 

[SET] 

TABS nlCnZ ... n28J 

Specifies Mhether a terminal 
is to be used in line mode or 
in full screen mode. 

CSETJ 

1 

TERMinal Typewriter i 

Display I 

i 

ShoMS whether keys are 
available. 

[SET! 

TEXT OH 1 OFF 1 

1 

Controls the display of TOP 

OF FILE, END OF FILE, TOP OR 
RANGE, and END OF RANGE null 
lines. Note that the initial 
setting is ON. 

CSET3 

TOFEOF ON 1 OFF 

Defines last column in which 
data may be entered. 

CSETJ 

TRunc n|*t 

Controls whether or not the 
number of blanks between two 
words is significant in 
target search. Note that the 
initial setting is OFF. 

CSETJ 

VARblank ON|OFF 
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I 

I 

I 



XEDIT (cont.) 

Controls whether or not sub- 
commandCs)*-changed lines are 
to be displayed. Also 
defines columns to be 
displayed on screen. Data 
may also be displayed in 
hexadecimal. 

[SET] Verify CON|OFF)[[Hid c2)... 

Controls use of wraparound. 
Note that the initial setting 
is OFF. 

[SET) MRap ON I OFF 

Defines starting and ending 
column of each record for 
target search scanning. 

CSET) Zone zonel zoneZix 

Inserts specified string into 
the equal buffer (see = sub¬ 
command) . 

CSET) = string 

Moves data either to the left 
or to the right. 

Note:■ Data loss is possible. 

SHift LeftlRightCcolsIlCtargetll)) 
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Description 

Format | 

XEDIT (cont.) 







Arranges a specified number 

of 

SORT target 

CAiOl cl c2 [cl c23... 1 

file lines in ascending or 
descending EBCDIC sequence 
according to specified sort 
columns. 






! 

Provides a set of functions 


SOS option 



1 

used mainly in XEDIT macros 

or 





1 

assigned to PF keys. 


ogti^^ 



i 



Alarm 

NField n 

Right n 



BField n 

NLine n 

TABB n 1 



CLEAR 

Nulls 

TABCmd 1 



Down 

n 

Nulls OnlOFF 

TABCMDB 1 



Left 

n 

PFn 

TABCMDF 1 



LINEAdd 

POP 

TABF n 1 



LINEDel 

push 

Up n 

Splits a line into two or more 

SPlit 

Column 


! 

lines at the column pointer 

or 


CURSOR 


1 

at the cursor. This is a 







macro. 



colno 







[BeforelAfter3/string/ 
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XEDIT (cont.) 

Places part or all of a 
specified number of lines into 
the console stack, starting 
with the current line. 

Displays the SET subcommand 
options and their current 
settings or creates an 
XEDIT macro that contains the 
SET subcommands with their 
current settings. This is a 
macro. 

Moves the line pointer to the 
null line above the first line 
of the file or of the range 
( see SET RANGE). 

Access, within a macro, 
specified editing variables and 
places their values in the 
console stack for subsequent 
reading by the EXEC 2 &READ 
control statements. 



TOP 


TRAnsfer keyword ... 

( more than one can be specified) 
IMage PFn TABLine 

IMPcmscp Point TABS 

LASTmsg PREfix TARGet 

LENgth RANge TERMinal 

Line RECFm TEXT 

LINENd RESERved TOF 


keywords 

APL 

ARBchar 

Autosave 

CASE 

CMDline 

COLPtr 
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Description 

Format 

XEDIT (cont.) 

TRAnsfer keyword (cont 

. ) 



column 

IRecl 

SCAle 

TOFFEO 


CTLcharCchar] LScreen 

SCReen 

T rune 


CURLine 

MACRO 

Seq8 

UP Date 


CURSor 

MASK 

SERial 

VARblank 


EOF 

MSGMode 

SIDcode 

Verify 


Escape 

NBFile 

Size 

VERShift 


Filler 

NONDisp 

SPAN 

Widtht 


FMode 

Nulls 

STAY 

UlRap 


FName 

NUNber 

STReam 

Zone 


FType 

HEX 

PACK 

SYNonymlnamel 

“ 

Displays a specified number of 

Type [target 111 



lines* starting wi.th the 
current line. 





Moves the line pointer a 
specified number of lines 
toward the top of the file. 

Up Cnixll] 




Translates all lowercase 
characters to uppercase ones* 
starting at the current line. 

UPPercas 

[target 111 



Edits multiple files in virtual 

Xedit Cfn 

[ft [fmlll [(options...[)11 


storage. 

options: 





Same as 

the command 

options (see XEDIT command above). 
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XEDIT (cont.) 


Adds one or more lines 
immediately after the line in 
Mhich subcommand is entered. 

Copies one or more lines and 
must have the F (folloMing) or 
P (preceding) prefix sub¬ 
command to indicate the 
destination of the lines. 

Deletes one or more lines. 


Extends a logical line by one 
more physical line. 

Identifies the line after Mhich 
copied or moved data (using the 
C or II prefix subcommands) is 
to be placed. 


The XEDIT Prefix subcommands (line subcommands) are used 
as folloMs: 

Prefix Meaning and/or Action 
A Add one line 

nA Add n lines 

An Add n lines 

C Copy one line 

Cn Copy n lines 

nC Copy n lines 

CC Copy block of lines 


D Deletes one line 

Dn Delete n lines 

nD Delete n lines 

DD Delete block of lines 

E Extend logical line 


F 


Data is entered folloMing this point 
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Description 


XEDIT (cont.) 

Inserts one or more lines I 

immediately folloMing the line nl 

in Mhich prefix subcommand is In 

entered. 

Moves one or more lines from M 

one location to another in the Mn 

file. nM 

MM 

Identifies the line before P 

Mhich copied or moved data 
(using the C or M prefix sub¬ 
commands) is to be placed. 

Displays the scale on the line. SCALE 

Displays every tab column in TABL 

the line. 

Sets the current line or /Inl 

identifies a line that Mill be CnJ/ 
the neM current line. 

Duplicates one line or a block " 

of lines. Must be a double ”n 

quote symbol. n” 

»fif 


""n 

n»»n 


Format 


Insert one 1ine 
Insert n lines 
Insert n lines 


Move one line 
Move n lines 
Move n lines 
Move block of lines 

Data is entered preceding this point. 


Scale becomes visible 

The letter "T" shoMs Mhere a tab is coded 


Make this line current and move the column 
pointer under the nth column. 


Duplicates one line 
Duplicate line n times 
Duplicate line n times 
Duplicate block of lines 
Duplicate block n times 
Duplicate block n times 
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XEDIT (cont.) 

Assigns xxxx as symbolic name 
to this line. 


.xxxx Foul —character symbol 


ZM 

Modifies or dumps MODULE, 
LOADLIB, or TXTLIB files. 


CMS 


(module } 

ZAP sLOADLIB f [libnamel ... libnameSlL(options. 

(TXTLIB ) 
options; 

[ TERM !INPUT filename] [ PRINT I NOPRINT] 


[)]] 


Control Statements ; 

BASE address 

DUMP imembername| csectname [startaddress tendaddrasslI 
Imodulenamel ALL 

LOG (fixname) [ ZAPLOG Ifiletvpc Cuserdatall 
NAME {membernameimodulename} [csectname] 


REP disp data 
(VERIFYIVER) disp data 
^ comment 


END 
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